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• Flexible OEM licensing 


ViBrt www.faircom.corrt/ep/mt/sdk today to take control of your server! 
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Copyright 2004 by Dave Mark 

BZFlag:A SourceForge Open Source Project 


Lots to talk a[>ouL ibis month. There’s a new version of 
Xcocle up on the net, 1 got an excellent new toy I’ll touch on 
brietly, and tor the main event, we’re going to download and 
build an open source Mac OS X program called BZFlag. 

The Latest Version of Xcode 

There’s a new version of Xcxxle on the Apple De\^eloper 
Connection web site. Definitely wonh the download. Make your 
way over to; 

http://connect.apple.com 

Login, then dick on the l.k>milo€it} Software link. Figure 1 
shows the section of the page dedicaied lo the new version of 
Xcode. version 1.2. 

XtodeToofsvl.2 

TTw XcDdo Totib 1 2 nlaaso & a Tun updott ol Vw Jtecda davulofxiwit Toolt tiuia II rc-qulr» Mac OSXvlcr.3.!i lo 
nitfli. and csn bo riiated dirocUy ovei anXcodo Toda 1.0.]i and U niTaiufjon Sm tho Rud Ma dPaumtnT 
imi 9 inlaffwikm 

nivrtwns Fonnol FUtrSlio 

XMde Too* 12 CD 22 Ap*' ZOtM Soanwnis - Dowm&id 1 

XoUdO Tugfa 12 READ Me 22A|3<2!XM PfW bH K j 


Figure L The Xcode dotenhad iisfing in Sa/arL 

If you are working off of an unadultenited Panther install, 
chances are good that you won't have an easy time icsing Safari 
to download the pieces that make up the new Xcode installer, 
Pommatcly^ there's a nifly piece of freew^are that will make your 
job much easier 

MisFox is from a German jm>grainnicT named Alexander 
Clauss and allows you lo edit all the file mappings and protocol 
helpers used by Mac OS X. In our aise^ W{; want to set the KiT 
helper app to whatever FLP client you happen to be dating at 
the moment. 1 lere's the LiRL for MisFox: 

http://www.clauss-net.de/misfox/misfox.html 

When I wrote this, version 1.2,1 was the most recent 
release. Figure 2 shows the main MisFox window. Note that 


there are 3 t^ibs to choose from: Defmdt Applications, fiie 
Mappings, and Prolocol Helpers. I used llie De/auil Applkalions 
tab to set my default FTT application to Interarchy, 

MM O _ MisFox . 

—-- { Dtftiuk Applicatton* Fiie Map^imgi ngtorol HdjP*” -—-- 

Sclea Inlcifwt ipfllLuIlDn) gmu wiih to uie default o^iplICattoAl... 


MaH: gntouragt _ f^ ' 

News ' MTNtwswATchor _ 

FTP”. TirtwajU^v 


biHccd I Edti N*w 

Figure 2 . The MisFox [)efauU Applications pane. 

If you go hack to Figure I, yoifll see a Download button to 
the right of the Xcode Tools U2 CJl Once you use MisFox to set 
your default FTP clieoL Safari will hand the list of files !x.hind 
that Download burton to your client for easy downloading. 

Xi'otie L2 consists of 21 segments. Download them, and if 
they are tvol auiomalically reassejnbled, just double-click on one 
of them, lire disk image will l>e mounted and you can nm the 
installer. Obviously, make sure you backup your hard drive 
before you dtj the install, just in ca.se .something goes liorril^ly, 
horril>ly wrong. 

When you first launch the new Xcode, you 11 have a chance 
Eo go ihroiigh the release notes to see what's new with I he new^ 
version. If you iniss your chance, go U) the Help menu and .select 
Show Release Notes. Lots of goexi info here. Still some issues to 
address, l>ui lots of fixe.s, making tlii.s release of Xcxxle more 
stable overall. 


Dave Mark is a long-time Mac developer and author and tias wriiren a number of Ixxiks on Macintosh development, induding learn C on Ibe 
Muchihisb. I.mrn G-F+ on the Macintosh, and The MadnUxsb Programming Primer series. 

Dave's Ixcn Ixj.sy lately cooking up his next coneextion. Want a jxek? http://wvvw.spfderworks,com. 
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An Awilsomi: New Keyisoakd 

Ib the March 29*^^^ issue of IklBits, Aclain Engst wrote a 
glowing review of llie Tactile Pro keyboard from Mafias. Here's 
a picture of the keyboard: 

http://halfkeyboard.com/taaflepTo/viewer/tp_mainpic.html 

Here's Adam's eloquent review: 
htlp://db.tidbits.com/getbits.acgi?tbart=07607 

1 liw on my IkwerBmk. Have a 17” Apple Studio Display. 
But liavc never found a keyljoard I was really happy with. Until 
now. As you II find when you read Adam's review, the designers 
made some excellent decisions wlien it came to laying out the 
keyhtxird. But to me, the most important aspect of this keyboaal 
is its incredible responsiveness. The keys on my PowerDook 
keyboard are mushy, Perhaps a better way of saying this is, 1 
t:an’t feel the micro-switches undeimeath the keys when I press 
them. Tlie keys on the Tactile Pro keyixiard, however, dack 
when I press them, the reassuring dack of a micro-switch being 
depre.s,sed. The throw of each key is deeper, meaning that J have 
to press each key down funher as I type. This inigln seem like 
a bad thing, but it is not. 1 atn tell when Pve [tressed a kc-y and 
the Tactile Pro keyboard is much more forgiving that any otlier 
keylx)ard fve tried. The result is much bister typing speetLs with 
much higher accuracy. 

If youVe ever typed on the t)ki Apple Extended Kt 7 board 
(think hack to the days of ihc original Macintosh II), yoiill have 
a sense of tlic Tactile l^ro. TI 1 L 7 usc^d liie same mechanic:al 
keysw'itches, and the result is bnlliani. 

You can buy it online at http://taailepro,com, $99.93. 

Mac os in an Open Source World 

A long, long lime ago, back before Coc'oa and the second 
coming of Steven P. Jobs, the Mac was pretr>' much an island. 
You W'cre either a Mac ix;rst>n or you were nt>t. When it cajne 
to Mac samjile ccxle, there were some wonderful communities 
.set up, bin they were always either Apple-driven, or altered for 
the most part to Mac people. If you found some coo! Unix/X 
windows code, chances are pretty good that any sample projects 
were set up for Windows or Unix-based environments, Mac folk 
need not apply. 

Now tiKil Mac OS X has passed througli tlie steep [jorlion 
of its adoption curve, there is mudi more of an acceptance of 
(he Mac' among the open source t rowel A perfetl example of 
this can be seen at tlie !>ig dog of development web sites, 
http://sourceforge.net. 

Now, you mighi think that yottr favorite web site has lots of 
.sample code and a big community of users, but no. This is big. 
JiourceForge has more than 800,(X)0 registered users (and that 
ntimher does not include the hundreds of thousands of 
developers who just like to poke around) and more than 80,000 
hosted projects. Tliose are crazy huge nym!>ers. 


In llie olden days, lliere might have been a few scattered 
Mac projects, but they would have been few and far between. 
Navigate over to httpr//sourceforge.net and click on the software 
map liulton, just below the banner ad towards the top of the 
window. Here's the URL that will get you there directly: 

https://sourceforgG.net/softwaremap/troveJist.php 

This is a useful page if you are looking for a project and 
know the topic. But you can also browse by other (categories, 
including OS. Click on tlie Ol^erating System link. Again, here's 
the direct link: 

https://sourceforge.net/softwaremap/trovejist.php?form_cat= 199 

Figure 3 shows the OS categories, along with the number 
of projects in each attegory. More Ilian ihree Ihotisand Mac OS 
pixijects. Hiis is cool! 

^ operating System 

Qj BeOS (438 projects) 

MacOS (3465 projects) 

Microsoft (20076 prayectej 
Qi OS/2 (135 projects) 

Qi OS Independent (20) 13 projects) 

C3 Other OS (1063 projects) 

Ca PDA Systems (743 projects) 

Ca POSIX (37939pro/ectsj 

F/gure J. 7]fje /rs/ (fSoi/rce/i)/ge /tsM t?y OS. 

If you click on Mac OS, and then on Mac OS X, youU find 
2,290 Mac OS X projecLs, 1,326 of which arc Cocoa projects. That 
is a pretty rich vein of interesting material to explore. Atid, who 
Icnows, you might find a project that interests you so much that 
you 1 i dig in and gel involved with the development process. 
SourceForge (and 0|X.ai Source, in general) is cool tliat way. 

It is wonh noting that there are many projects that 
.support ihe Mac or will just plain run on the Mac tliat are 
not necessarily in the MacOS category. For example, 
there are several thousand Mac-sawy projects in the OA 
/m/epcm£te/t/ and POS/X categories. 

Read through the rest of this column, then start digging 
around, see what you can find. 


Building BZFIag 

Each month, SourceForge nominates a Prq/ect of t^e MofM. 
This past April, the project of the month was a cool Lank-based 
shooter game named BZFlag. Here’s a lLrLl< to tlie SourceForge 
BZFlag page: 
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https://sourceforge.net/potm/potm-2004-04.php 

Cool! Pit1ure*s of Tim Rikcr, Diivid TrowlsridgL-, and Scan 
Morrlstjn, BZFlag's key developers. Tile page contains a lot of 
interesting info, including an interview with the principals. 1'his 
is pretty lypiral of a “poim" (project of tlic monili) page. The 
polin URLs are well constructed, so you replace the 2004-04 witli 
a 2004-05 to get to the March project of the month: 

https://sourceforge.net/potm/potm-2004-03.php 

'fhe porm page is more of a marketing page. On ii, you 11 
find a link lo the SourccFoige BZFkig Pwjecl fmge. 

https://sourceforge.net/projeas/bzflag/ 

This is tlic actual SoorceForge home for liZMag, where 
you 11 go to download the various sources and binaries for the 
different platforms BZFlag supports. These pages arc well 
organized. Figure 4 shows the listing of recent BZFlag hie 
releases. I'he link at the bottom of tlie figure takes you to a page 
with a much more exhaustive listing. 


Ftle 



version 

Dati! 

Not£S / Monttw 

Downtoac 

bzvdit sdurce 

1.6.2 

January 1% 2004 

m -a 

PcwtiJoac 

wlft32 

C6.2 

January 19, 2004 


DDwnloac 

bxfiag gccl JtBl 

1-^ 

Jm 17, 200J 


ODwnluai: 

use ipm gccl (rti 14) 

ClO-a 

January 2^ 3004 


Download 

bzfiag me OS X 


January 24. 2004 

#.0 

OawfT^Q^ 

bzfiBfl fi32 ml|»3 Irix 5.34 

1 1®.4 

January 24, 2004 


OuwnlDaC 

bzflag a22 mips2 Itix 5.34 

l.7e6 

September 26, 2002 

# -0 

OownlDac: 

bzftag old ait:.rpfn (tide -tb) 

i-7g2 

June 17, 2003 


JJawntoaC 

bxflag ppe rpm 

i.7*!2 

May B, 2001 


Dnvmloac 

bzflag stack ware 

iao.4 

January 24, 2004 


Dciwnloac 

bzflag source 

I.IQ.S 

April 2S, 2004 


D&wnJoac 

bzHag wtit32 

1.10.4 

January 24 , 2004 


Downlaac 


IVsew Mt Prp}e« Rl«t 


f igure 4 The lisl of recerti BZFia^Jiie 
raleam on the project page. 

If all we were interested in was the app itself, we could 
download the binary for our platform. Now BZFlag is a lot of 
fun to play, hut there's something gratifying aftout successfully 
building an app on your own machine, especially an app as 
complex as this one. 

Click on the hzflag source link towards the lx mom of the 
lisl. Be sure to click on the one witli the imisi recent date. As 
you can see, Fll be working with the one labeled April 25, 2004. 



Foi more Infonnation. visit www.sUckedit.com/mac 1.800.934.EDIT +1 919.473.0070 


m 


SlkKEdii li.a |n<. flllur numB* -njkv ba naa^maiks cflfiatf retjaec^v# < 




■k 


rt* 

V 


slick^dit. 

Develop an etige. 


The best code editor on the planet 
is now available for the Mac. 






Volume 20, Issue 6 • MacTeoi 


BZFlag; A SourceForoe Open Source Fhojelt 


















This link will lake you lo a page listing vaiious source 
releases, including tile one you selected. Source code is arcliived 
in a number of different ways, depending on the OS. In general, 
you do noi want to download a .zip file. This will likely be a 
build intended for a Windows machine. Tlie fxrniiissions will not 
be setup for Mac OS X, and there will also likely be carriage 
return/line feed confusion as well. F<^r Mac OS X, look for a 
tar.bz2 or a tar.gz archive. 

Click on the link labeled: 

bzflag-ri 0.5.20040426. tar.bz2 

This will take you to a download page. Select your nearest 
location and click the link to start the download. Stufflt 
Expander will expand the archive just fine. 

In the Finder, open the newly expanded directoiy. In my 
case, ii was called hzflag-1.10.5^20040426. Now open the 
sulxlirectory src/platforni/MacOSX. As the name implies, lhe.se 
are the build files for Mac OS X. 

Open the Xc:ode project file in the MacOSX directoiy. 

Wlien the Xcode projecl window ap^x^ars, dick on the 
targets popup menu (it’s in the upper-left corner) and select 
RZFlag {Figure 5)^ 
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Figure 6. Be sure you your huikJ window by dragging the 
dot front the battoni of the windoip towards ibe middle. 
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Figure 5- The BZFlag tafgets lx)jnip from 
the BZFlag project wimiow. 

Now seiecT Build and Fun from the Build menu. This is 
gonna take a while, so this might l>e a gtxxl time to alj)hahetize 
those Zamlir pan flute CDs you've lieen collecting. 

When you start the build, if nothing appears to be 
hapt:>ening, it may be that you have the split closed in your build 
window. If your ImikI window is nor divided into two distinct 
panes, dick on llie dol on the bottom edge of the w'indow and 
drag it up, towards the middle of the windt>w (Figure 6). Tlie 
build is driven by a set of Makefiles (Unix build scri]>ts) and the 
script steps are shown in the bottom pane, while Xcode’s 
compile messages will be shown in the top pane. 


If you gel an error message during the build process, try 
changing the target to BZAdmin. doing a Bmld of that target, 
then selecting BZFlag as a taiget and doing a Build and Run 
again. Worst case, do a Build of the FjK^rytbmg target, then seiecl 
BZFlag and do a Run. You need to run the BZFlag target to mn 
the game. 

Have fun playing BZFlag, It w'ill lake over the entire .screen 
and put up a simple menu. Navigate the menu with the arrow 
keys and the return key. F-scape takes you back up a level. Your 
choices are Join Game, Options, Help, and Quit. Review itie 
help and options if you like, then select/oi>7 Game. This will 
take you to a new menu screen. Select Find Sefvm\ scroll 
liirt)ugh ihe list of servers to find a game you like, select the 
game, then select Connect. 

ITiar’s it. YouYe in the game. And there Ls always a game 
going, li is amazing licw lug this game has gotten. When you 
are dtxie playing, hit e.scape, then arrow down to Quit. 

Doing a Unix Build 

Not eveiy Mac OS X project will sliip w'ilh an Xcode project. 
'FhaFs OK, though. As long as the developers included the 
appropriate make files, we can use iho.se lo dt) our build. So if 
you had some trouble with your Xcode build or if you just want 
to give the UnLx build process a try, here's the process. 

Start by launching the Termmal app, 

U.se the cd command to navigate into the lop level of the 
BZFlag folder you downloaded. For example, 1 unstuffed my 
art:hive onto my desktop. From my home directory, I did: 
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c4 Deijktoi> 

and then 1 did: 
cd bzn^glJQ. S, 20040^*2 & 

T then did: 

. /autoj^fin .sb 

Tliu leading tells the Unix shell to execute the shell 
script contained in the file autogmsh found in ific current 
directory, that is, in the directory hzJh:ig-lJ0.5J004042(x 
The script liangs a hit, then spits out this message: 

EZFlag sources are now prepared. To build her^* run: 

-/configure 

make 

And that’s exactly what you want to do next- First, type; 

./configure 

This will create a hunch of Makefiles and do a few tjther 
things. When tl is done, type this coininand: 

make 

Got a dual processor G5? If so, do a: 

niak“ -j2 

This tells make to split the task into two concurrent jobs, 
GeLs the jol) done in half tlte time! 


This will take a while. You 11 be compiling a fairly large 
l'>aich of code, so sit hack anti dream aliout GiUigan*s Isiand. 
Who would you be? Hmmm.-* 

By die way, in case you were wondering, gcc is the: C 
compiler, and g++ is the GNLI C++ compiler- 

llie build should take alxiui 10 minutes (obviously, 
depend.s on your processor). To run tile binary, be sure you are 
still in that top directory and type the command: 

src/bzflag/b^flag 

If you get an error message, do an Is and verify that there 
is a directory named sre m the current dirucloiy. If not, you may 
have changed directories. 

Tn.L Next Monjii,.. 

Hopefully, i>eaweea die Xcode method and the Terminal 
inediod, youVe gotten BZFlag to rim, Here are a couple of 
BZMag related sites that can help you witfi your gameplay: 

http://www.dervishdukol.ofg/home/bzfl3g/bzflag-html 

http://bzflag,org/wiki/ 

A1.SO, if you are IRC-sawy, you can make your way over to 
^rbzflag on irc.freenode.net with any questions or comments. 

Your liomework assignment is to searcli through some of 
ihe other 0[)en Source projects on SourceForgeme! listed in the 
Mac OS X area, find one you like, and get it to buikh 

A huge .shout out to Scan "hrlcad” Morrison for his most 
excellent help in getting BZFlag to build. 

Oh, and be sure to head over to http://www.spicterwofks.com 
and Sign up for the email list. See you next month.,.© 



Now serving Cocoa® 
just the way you want it. 

Training for Mac OS X doesn’t have to be the same oid ftavot; >i 
Reserve your seat in a class at our scenic lodge location, 
or have experts coroe to you for Extrema Mentoring. 
Two weeks of on-site instruction and coilaboration, 
customized to the requirements of your project. 
Book now for 2003. See why we’re different. 
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MAC OS X 

PROGRAMMING 

SECRETS 


By Scott Ktiaster 

Screen Savers in Cocoa 


One of the cliissit: m^ntm-like goals For computer science 
over the past 20 years or so has l>ccn to ‘'Make simple things 
simple, and complex things possible”* Programming wiilt Qx:oa 
has a somctimes-complex learning curve, but once youVe 
swerved through that curve, tliere are definitely a hunch of 
things that are much easier to accomplish tiian tliey were in the 
old pre-OS X world we knew and occasionally loved. Writing a 
screen saver is a perfect example; it should be simple. Most 
typical OS 9 application programmers never dipped llieir toes 
into the slightly wacky world of screen savers, but witli Cocoa in 
OS X, implementing a screen saver is well within everylxxly's 
grasp. In this montIVs column, well take a look at 1k>w to get 
your very own screen saver up and, er, saving* 

HiiRii’s WiiAJ We’re Gonna Do 

Let's Stan by taking a look at the process for creating a 
screen saver in OS X. i lere are the broad steps: 

Create a new screen saver project in Xcode* 

Edit our M file. 

Override meih<KLs and write other code in our .m nie. 

Build the |>it)jcct iu create a ,saver package. 

Install the .saver package by putting it into the 

Library/Screen Savers/ folder. 

Open System Preferences and see a preview of our screen 

saver. 

Fnjoy the savings! 

We'll go through each of these steps in greater depth now. 


Lnn.F. Heip 

I'he basic magic that makes screen savers so easy is the 
Screen Saver framework in Cocoa. Tim framework defines ilie 
ScreenSaverView class, which is a $ubcla.ss of NSView* By 
creating your own subclass of ScreenSaverView and adding some 
ctxle, you define your screen saver. The Screen Saver framework 
alst> defines the claSvS ScreenSaverDefaults. w^hich you can use for 
handling preferences for your saver Along with these classes, 
the framework provides some handy utility functions you can 
use in your cocie. 


Well go over some of the most interesting methofls and 
functions in the ScreenSaverView class. Yt>u will rarely call 
methods defined by ScreenSaverView - most of the work is 
creating your own siilK:lass and override some methods, 

initWirhFranie: is Preview; 

* (Id) InlttfittiFrarap: fNSRect) fraini! isprevlew: (BOOL) is Preview 


You override initWithFrame in your ScreenSaverView 
sultcfas^s. The system calls initWithFrame when the .screen saver is 
alxjui take over die screen or is selected in System Preferences, 
llie frame parameter is the fVanie rectangle for the view. Tlie 
isPraview panimeter tells w^hether the screen saver is aciuuUy 
lK*ing invoked or is merely being asked to preview Itself in 
System Preferences (as shown in Figure 1). 


r> o 
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jFifgKre L Eafi can premeu^ ibe sertmt sai^^r in a iittic bfjoc in 
System Pre/erertces. In yaur code, you cart leii whether the 
screen saver is drawing full-screen or in the prtnHew box. 


Scott Knastcr writes books, including the recenlly published Mac Toys and the brand-new^ Hacking iPod ami ilhriL^ bolti I roni Wiley Publishing, 
Scott can't rea<l ant) listen to vocal music at the same lime* Scott writes these little bios in the third person* Write to Scott at scottk@mactech.com . 
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startAnimation 

- (void) StartAnimatIon 

The system calls startAnimalion [)ef<)rc ihc screen saver 
is abt>ui tt) Stan drawing. You sltould override startAnimation to 
set up your screen saver’s initial state, such as setting line widths 
or loading images. You should call the inherited implemcntatirm, 
or bad things might happen, such as incorrect drawing, or all 
water on earth instantaneously evaporating. 

animateOneframe 

- (void) FinimateOneFcame 

This is where your screen saver gets to show off its amazing 
graphical skills. Mac OS X asks your screen saver to do its 
drawing by calling animateOneFrame repeatedly. You can 
actually do your drawing in animateOneframe or in drawRect, or 
even a little in Ik ah places. If you make any changes here that 
require fiirther redrawing, your implemeriiacion should call 
setNeedsDisplay:YES, which will cause drawRect to Ix.^ called. 

dravRect 

- (void) drawRectr(NSRect)rect 

Override drawRect to draw the screen saver view. You can 
do your drawing in animateOneFrame, or you can dt> .some or all 
of it here, red is the rectangle you're drawing into, which is 
handy to have when you want to erase the view and Stan 
drawing afresh. 

HtopAnimation 

- (void) fitopAnimation 

when Mao OS X wanus your screen saver to stop doing its 
tiling, it calls slopAnimation. You can override stopAnimation to 
release resources or do any other cleanup you want before your 
screen sjiver goes away. 

Saving Time 

Now that you’re familiar with the cast of characters in 
ScreenSaverView, let’s go ahead and code up our screen saver. 
To start, we’ll open Xcode and create a new project of type 
Screen Saver (see Figure 2). 
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figure 2 Creulhtg a new Screeti SatKTpwJect gels }fou 
started with the Screen Saierframetmrk, indtuling 
)Kmr own subclass of ScreenSmKwVieui 


This j>r()vcs lluit Xttvtle already knows nknif tfu' screen 
Sliver framework, which saves us [ilenty of work. Our new 
projeci alreatly conuiias a subclass of ScreenSaverView, and we 
already have ihe usual ,h and .m files. We’ll edit ihe .h file that 
Xcode gives us until it looks like this: 


tfimpyn CSc reenSaver/ScreenSaver,h> 


Winterface SaveyerVlev i ScreenSaverVicw 
( 

NSBezierP^lrb *path; 

I 


§end 


'rhe header file is preny darn i>asic. All we do licre Is rreaie 
a sulKlass of Screen Saver View and add an NSBezierPath object 
to keep track of w luU wcYe drawing. 

Now let's get into the iinpleinentation files anti see w'hat we 
tan find. When we told Xcode to create a new Screensaver 
project, it start us off with st>ine code, including the 
implementation for lnitWithFrame:isPfeview:, the designated 
initializer. In this ease, weYe able to use the supplied etKie for 
initWithFrame wiilioitt any changes: 


- (IdlinitWithFraire: <KSRect)fraiise InPrevlewi (BOOL} IsPteviott 
( 

eelf - fstip^r initWithFramp:frame isPreview;lsPrevievJ: 
if (self) t 

[self seiAniniarionTiiiielnterval:i/30.0]; 

// Draw 30 fraincs per second 

1 

return self: 

) 


The code here starts by calling tlie inherited implemcniation. 
After that, we use setAnimationTimeInterval to tell Mac OS X that 
we want (]ur screen saver to draw 30 fntines per second. As I 
mentioned, this Is ihe default code dial Xcode writes for this 
method. You can modify it if you want to perfonn some other 
task when the screen saver starts up. For example, if your screen 
saver has yser%seUal>le OfHions, you can handle (hem here. 

Next, w'ell take a look at our startAnimatton inethtKl, which 
the system c:alls right l^efore asking our screen saver to start 
drawing. Our iin|>lemcnUition of startAnimation Ix*gins by calling 
the inherited implementation. Tlien, we create our Bezier palh 
and choose a nifty line join style: 

^ (vijid] StartAnimation 

I 

NSPoipt XI 

[super starrAuimationl: 

path = f (NSBezierPatli alloc) init]; 

//IStlt use a Berief path ft>f drawin}? 

[path setLincJoinSiylet HSKoundLineJoinSiyieJ; 

// Jii« for iiio, cinineci iIk linc*i wiih 
// a round joini 

Wlien the system asks t>iir screen saver to get ready to 
draw, we can call the view's (sPreview method Ui see if weYe 
Iteing asked to draw on the full screen or in the little preview 
box in System Preferences (as .shown back in Figure 1). 

We can use llie result of isPreview to make decisions about 
jtist w^hat to draw. In our screen saver, well make the lines skinny 
lor the preview, and fatter for tlie real, full-screen version: 

if (iBelf iBpreview]] 

//Vtlien drawing a pn^vit:^; makr fhi^ lints 
// much thinner than when savinj^ screens, 

I 

(path setLineWidth: 0 , 0 ): 

//This is the thinnest jx^ssible line width 

I 

else 

I 

[path isetLiupHidth: lO.lBh 
//Thi.'i line width W'us chiiiiefi at randimi 
// OK.attualh', it’s my sun s liirihdaic 

J 

Our last task here is to get the Bezier path started. Well 
do iluii by picking a random siarting point and moving the 
path there: 

X = SSRandomPointForSizeWithlnRect 

(NSMakeSize (0,0). Iself boundul); 

// CM utility runciiun Ui la nindrmi pi^int 

f path dinvfiTn Po t n t: x 1 1 
// Sort the path at the nndnm point 
I 

We get a random point by calling 
SSRandomPointForSizeWithinRect, a handy function provided by 
the screen saver framework for just this purpose. Hc)t)rjy for 
handy functions! ilien, we simply move the path pen to dtat 
random pt>int to start it out. 
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Evemhing thm starts must end, and the next method we 
define is stopAnimation. which is called wlicn liic system doesn't 
need the screen saver to draw any more. Here's our 
implementation of stopAnimation: 

(VOid)£ topAnimation 

I 

1super stopAnimatidn ]i 

[path relf.afldl; 

// RtHrasc The path 

path ^ nil; 

//llii (jur MTtx’ii Kivcr vkw tliut ihtre’K no path 
I 

'J'he standard StopAnimation provided by Xcode simply calls 
the inherited implementation. In our version, we keep that super 
call, and add code to release the Bezier path object and set the 
path instance variable to nil. 

Every lime the system wants our screen saver to tJraw 
anoilier piece, it calls our animateOnoFrame medrod. Let’s lake a 
look at that First, we'll call that convenient 
SSRandomPointForSizeWithinRect utility function lo gel another 
random \xnni: 

- tvdid}aniiaateOneFraflid 
f 

NSPolnt uti 

X SSRanddinPoinLFarSizeWtThinRect 

(NSMakeSlsse (0.0) , Iself boundsl); 

// tiel A nitid<aii point to fxiemi the lie/ter paih 

We want our screen saver to draw a bunch of lines on the 
screen, anti every so often, we want it to erase the lines and slan 
oven Let's ,say we want 50 lines at a time, in honor of our 50 
stares. If we haven't reached 50 yet, we add the new nmdom 
point lo the path: 

if ([path tlemi^ntCaunt] < 50) 

// Draw 5(1 lines hdnnc erasing 

1 

[path lineToPoitiii xj; 

//11 wf duni luve 50 ycuadd the 
// new [xiiiil 10 the line 

) 

Once we have 50 points in the path, we want ro reset the 
path by callously discarding all poinLs and then start building it 
up again: 

else 

I 

[path rcnoveAl1Pointsir 

[path nwvcToPoint :xj; 

// If Wf ik> have 50. ckiti om thf pith 
// ukJ gf l ready to start over 


We finish by telling the system that weVe messed with the 
path and it needs to be redrawn by calling the .screen saver 
view's drawRect method. Alternatively, we could do the actual 
drawing right here in animateOneFrame: 


[seif setKeedsDisplay:YBSl; 

//Tell the syrstem that Homeihing has changed 

// and drawRea should be orllwi 
I 

'rhe actual drawing liap[Kms in drawRect. which we'll l(x>k 
at NeXT. We start by calling the inherited drawRect. which by 
default erases die hackgroimd to black. 

- Cvoid)d rawRec t:{NSRect)rec t 
t 

NSCnIor "cnloc; 

[super drawHoct j rect ]i 

We then choose a pretty' color, and call set to make sure that 
the drawing Itappens in that color Then we call stroke on the 
Bezier path object lo actually draw llie thing: 

colsr ” [NSCulor colqrWithCalibratedR^d: (0,0^) 

grt!eni(1.0) blue: (1,0) alpha: tl .0) 1; 

[color setj : 

// Set the wlor iQ tol. tk> Sliarks! 

[path struke]: 

// Draw the Bezkr path 

1 

The la.st method we implement Ls our version of dealloc. 'I'he 
view’s fkzier path is the only allocated object we have to worry' 
about, so our meiliod l(K)ks like this: 

' (void) dcailoc 
[ 

[path release]: 

// Release the Be;:icf parh 

[super deallcMr]: 

I 

Put Me In, Coach 

When we have all the source code done* we build our 
project. If eveiy^diing builds OK, a file with the suffix .saver ends 
up in the project's build folder. To install the screen saver, start 
by tjuiiiiog System Preferences if it's running. Then move or 
copy the .saver file into Uie /Library/Screen Savers directory. You 
can put it in '-/Library/Screen Savers if you want to keep it all to 
yourself and prevent other users from seeing it. 

Once our screen saver is in the tblder, you can stait System 
Preferences, click Desktop & Semen Saver, click the Screen Saver 
lab, and select our screen saver in the lisL You .should see the 
skinny lines in the preview mo<le. 'I'hen click Test, and observe 
the big teal lines with their round elbows. 'Itiere you go! You can 
get this month's code at hup://www.papLTatr.com/mt/Jim04.zip 

If you're intere.sted in making your own screen stivers, tltcrc' 
are lots of directions you can go from here. Add user-setutble 
options by overriding die hasConfigureSheet and configureSheet 
meihcxls. Lise random colors. Do some much fancier drawing in 
your animateOneFrame method - for example, draw shapes, use 
cyrveToPoint instead of lineToPoint, or load images from disk. 
Whatever you do, have fun, and remember: the screen you save 
may be your own. 
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PROGRAMMIIUG 


Hy Paul Ammann 

Manipulating Arrays of Arrays in Perl 


1. Deciaration ANfy ActiRss OF Arrays of Arrays 
The simplest thing to build is an array of arrays (sometimes 
imprecisely called a list of lists). it‘s reasonably easy to 
understand, and almost everything that applies here will also be 
applicable later on wiih the fancier data struaures. 

An array of an array is just a regular old array ^AoA ihai 
you can get at with two subscripts, like $AoA[3][2]. Here's a 
declaration of the array: 

* assign to our array, an array of array references 
tAoA = t 

I ‘■fred"» “barney” J. 

I “george”^ “Jane”* “elroy“ ]. 

[ “homer"* "marge", "bart" J . 

print $AoAt?][7.1i 

bart 

Now you should l>e very careful that the ouier bracket type 
is a round one* that is, a parenthesis, lliat's Ix^x'ause youVe 
assigning to an ©array, m) you need parentheses. If you wanted 
there no£ to be an @AoA, hut rather just a reference to it, you 
could do something more like this: 

* assign a ftftttnee to array (d array rtferences 
5ref_tQ_AoA = [ 

I "feed", "barney”, "pebbles”, "bambara”* “dlno”. ]. 

I "horoer“* “bart". "marge", "waggle", ], 
t "george", "jane", "elroy". "judy". ]* 

print $ref_to_AoA > [2]f2]: 

Notice ilial tlic outer bracket type has changed, and so our 
access syntax has also changed, 'fhat's because unlike C, in perl 
you can't freely interchange arrays and references tliereto. 
$fef_io_AoA is a reference to an array, whereas ©Ac3A is an array 
proper. Likewise, SAoAp] is not an array, but an array ref. So 
how come you can write these: 

$AoA[2][2l 
$ r e £_to__AoA - > 12 ] [ 2 ] 

instead of having to write these: 

5AoA[2] ->[2] 

$ re£_to_AoA - ^ [2] - > [ 2l 


Well, that’s because the rule is tliat on adjacent brackets only 
(whether st|uan: or curly), you are free to omit the piiinter- 
dereferenemg an'ow. But you cannot do so for the very first one 
if it's a sailar containing a reference, which means that 
$ref_la_AnA always needs it. 

2- CiROWiNfi Ytnm Own 

That's all well and good for declaration of a Fixed data 
stmeture, but what if you wanted to add new elements on the 
fly, or build it up entirely frr>m .scratch? 

First, let's IcKik at reatiing it in from a file. This is something 
like adding a row at a time. We'll assume that there's a flat file in 
which each line is a row and each word an element. If you're 
trying to develop an ©AoA anay containing all these, here's the 
right way to do ilial: 

MU «>} I 
Rttap ' split: 
push #AoA* t #tmp ]; 

1 

You might also have loaded tliat fi-tJiu a function: 

for Si ( 1 10 ) I 

$AaA[SJ] ” 1 i7fJiiiefunc(Sl) 1; 

1 

Or you might have had a temporary variable silting around 
with the array in it. 

for Si ( 1 .. 10 ) l 
@tmp = aomerunc($l): 

SAoAlSiJ = [ @linp ] : 

It's very important that you make sure to use the IJ array 
reference constnictnn That's l>ecause this will l:je very wrong: 

SAoAlSll ^ ^tinp: 

You see, assigning a named array like that to a scalar just 
counts the number of elements in @tmp, which j>robably isn’t 
what you want. 
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If you are running under use strict, yoiril have U> add sonie 
declarations to make it happy: 

itee strictj 
aylBhoK, etnp): 
while (<>) ( 

^mp ” split; 
push #AoA, [ itinp ]; 

I 


Of course, you dcm'i need the temporary array to have a 
name at all: 


while (<>) I 

push [ split ]; 

] 


You also don't have to use push(). You could just make a 
direct assignment if you knew where you wanted to put it: 


nry (&AoA, $1* $line); 
for $i ( 0 10 ) I 

$lirLe » <>* 

$AoA[Si] = f split ' \ Sline 1: 

1 


or even just 


tay (@AoA* Si): 
for Si { 0 10 ) I 

SAoAtSi] - \ iiplit ^ Oh 
i 


You should in general lie leery of using iundions that could 
potentially reuirn lists in scalar context without explicitly staling 
such. This would be clearer to the casual reader: 


ray ^eAoA, $i); 
for Si ( 0 .. ID ) I 

SAoAlSi] * I split ‘ '* BcalarlO) J; 


If you wanted to have a $refjo_AoA variable as a referent'e 
to an array, you'd have to do something like ihis: 


while (<>) I 

push §$ref_to,^AoA. [ split 

\ 


Now you can add new rows, Wliat alxjut adding new 
columns? If youVe dealing with just niatiices, it's often easiest to 
use simple as.signment: 


lot $x {I 10) I 
for $y (I JO) f 

SAoAlSxlt$y] = func($x, $y): 
I 
I 

for $x ( 3. 7, 9 ) r 

$AoAESxI [2<>] +“ fuoc2fSx3: 

1 


It doesn't matter wliether those elements are already there 
or not: it1l gladly create them for you, selling inlervening 


elements to undef as need l>e. 

If you wanted just to append to a row, you'd have lo do 
something a bit funnier kjoking: 

t add nev coluMis to an existing row 
pnsb @l SAoAiOl L ’‘wilraa"', “betty"; 

Notice that I coukirfl say just: 

push SAoAtOj» “wilna"* "betty"*; # WaOtCf 

In fact, that wouldn't even compile, How' cxjmc? Because 
the argument to pushC) must be a real array, not just a reference 
to such. 

3, ACXms AND PrIN J INCi 

Now it's time to j>nnt your data stnictiire out. How are you 
going to do that? Well, tf you want only one of the elements, 
it's trivial: 

print $AoA[Dl[O]: 


if ytHi want lo print tlie whole tiling, though, you can't say 
print «AoA: # WRONG 

because you'll get jusi references listed, and perl will never 
autoniatically dereference things for you. Instead, you have to 
roll yourself a loop or two. This prints llie whole structure, 
using the sheil-sLyie forO construct tt) loop across tlie outer set 
of subscripts. 

for $aref t #AqA ) I 

print '\t \ @Saref J.Vn’*: 

I 

If you w^anted to keep track c)f .subscripts, you might do this: 

for $i f 0 S#A0A I [ 

print "\t olt Si U r «f$AoAlSlIi 1.\n": 

t 


or maybe even this. Notice the inner kK>p. 

for $i (0 .. $#AoA ) t 

for $j [ 0 .. $#i$AoAl$iJ| ) [ 

print “elt $i Sj is $AoAl$ll [$Jl Vn"': 

] 

I 

As you can see, it's getting a bit complicated, lliat's w'hy 
.sometimes is easier to take a temporary' on your way ihrtjugli: 

for $1(0*. $#AoA ) I 
Saref = $AoA[Sil: 
for $j (0 S#t$areft ) [ 

print “elt $i $i is $AoAl$i] l$jj\n'‘: 

I 

i 


Ilmm.,, that’s still a bit ugly. How about this: 
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for $i C 0 $#AoA ) ( 

$aref SAoA[$l] ; 

" #Sarer 1: 
for $3 ( 0 .. $n J i 

print “«it $i $J is $AoA[Sil [$31 ^tl’*; 

* 

1 


4. SiJCEs 

[f you want to get at a slice (part of a row) in a 
mulitdimeasional array, you’re going lo have to do some fancy 
sul)scnt>ting. Tliat’s l)ccausc while we have a nice synonym for 
single elements via the pointer arrow for dereferencing, no sur:h 
convenience exists for slices. (Remember, of course, that you 
can always write a loop to do a slice operaUoa) 

llere*s how to do one ojKTation using a loop. Well as^sume 
an @AoA varial:»le as before. 


@part = () I 
Sx » 4; 

for ($y = $y < 13: $y++J E 
push $AoA [$xj I$yJ; 

) 


That same loop could be replaced with a slice operation: 


Spart ” #1 $AoA|4] ) [ /..12 ]: 


but as you might well imagine, this is pretty rough on tlie reader. 

Ah. but what if you wanted a tim-dinmisfonalslice, such as 
having $x run from 4.,8 and $y run frt>m 7 to 12? Hmm.** here’s 
the simple way: 


irve^vAoA ” t J; 

for ($startx = $x “ 4: $x <“ 8: $x-h-) t 
for ($si^irty “ $y = 7: Sy 12: $y+^) E 

$ii«wAoAl$x - Sstartxl [Sy ' Sstartyl - $AoA[$!d [$y]: 

1 

1 


We can reduce some of the looping through slices 


for (Sx = 4: 4x <“ S: $x++) I 

push ervewAoA, [ SAoA[$xJ 1 [ 7♦-12 J ]: 
I 


if you were into SchwarUian Transforms, you would 
probably have selected map for that 


0newAoA “ mp I [ #[ $AoA[$J ) 1 7. *12 } J 1 4 .. 8i 


Aldiougli if your manager accused of seeking job security 
(or rapid insecurity) Llirt>ugli iascmlahle code, it w^ould l>e hard 
m argue. :-) If 1 were you. Td put that in a funclicm: 

^ewAoA “ splicu_2D( \9AuA. 4 => S. 7 => 12 ): 
sub splicG__20 I 

ray $lrr = sliift:# ref to array of array refsl 
fliy (Sk-1o. $x„hl* $y_lo* SyJxlJ §,: 

return map I 

[ m $irr~>UJ ) r $y_le .. $y_hi ] ] 
t $x„lo .. $x hlj 
I 
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By Dane Wooldridge 


Defining the Upgrade Path 


Building a Relationship with Existing 
Customers 

In Lvsues, wcVu 1‘cx.used priiiiarily on marketing methods 
for atiraciing new aistmiiere. Sane of these tetiiniques incliKk^l tlie 
use of press releases, listings on software sites (like 
VersionTrdcker.com), web site promotions, e-mail newsletter imiiling 
lists, etc. And while all of iliese marketing vehicles are also a great 
way to ajinounce new product updates to your existing aMuiiK.'[s, it 
places the responsibility on the customer to seek out die latest news. 

Itie prolMem with tills approach is dial you lase caitrol of die 
information delivery. You have no idea if and when the inajority of 
your oistomers will find out alxxii your new mlease. Sure, you 
could send out an e-mail to your customers, notifying liiem that a 
new^ version is available, but with the cunent ,state of frenzied niidl 
blcx:kirig programs Uitding the never-ending onslaught of spam, 
your e-mail could accidentally end up in spam tnisii folders as a false 
positive. Ymt have no way to guarantee that your e-mail will lie read 
by every red(>ient. 

Controlling the infonnaiion flow to your aisiomera Ls im(x>rtanl 
for five reasons: 

l^revenLs your marketing message from getting diluted or 
binned. Instead of simply posting your press release, some news 
sites w^riie their own editorial spin on your new produa update 
announcement. Often, some of die primary^ phrases and new 
fcaiuies listed in your press release are omitted from the news story, 
lettving out key^-selling points that would convince matiy atstomers 
U> upgrade. 

Helps kc\*[) yoiii' cxistomem satisfiecL Customers wlro arc* al)le 
to quickly resolve bugs by installing the latest maintenance UfKlate 
as s<x)n as it is available are less likely to get faistrated and more 
likely tt> remain a loy;il customer 

Renxjves disiacles. Ijet’s say you jasi released versliin 4.5 of 
your pfodiKt, but you still have some custtxiicrs who aie using 
version 3-0 Ix-cause tliey arc liolding out for a desired feiaire to Ix" 
adde^ Ixffore committing to pay for the latere upgrade. Tlx.'se are 
atstomers thiii are ready to give you their hard-earned money - all 
they need to hear Is tlial their requested features have been added to 
tile latest relaise. Efiectively communicating those magic words to 
these specific atstomers sliould be a priority^ when announcing tiew 


pixxJiict updates, A great aLStomer service teciinicjue Ls to include tlie 
customer's name and e-mail address in your feature requests records. 
Hach titne a feature ret|uest Ls implemented in a new release, send a 
quick e-mail to thxU austomt^r, notifying them that tlidr Tcquested 
feature is now available in the latest versicjn. They’ll appreciate tlie 
personal uxtcii and more often tltiin not, reward ycxir eflbrLs l:>y 
Ixiying the major upgrades and remaining a loyal customer. 

Improves your sales pcxential. Tlie rnorc* customers tliat are 
a wan' a fraid upgrade Ls available, tlie |^-titer chance that you’ll see 
an iticTcase in upgrade orders. 

Allows you to provide prcxtarve (uslomer scrvicx:, Ctistomeis 
who find out alxHit limiicd lime Ujigrade ofl'ers AJTCR die expiration 
date are going to lx- very u[5sel dml they missed tlie sale opportunity. 
Tliey'll lx* furious dwt you did not Inform them in a timely niiinner. 
liven if ycxi did send ihem an emiitii (that was mistakenly mushed by 
their spun filter), tlic^’U sdll likmie you Ibi’ the mishap, In this situation, 
you sliould extend die expired upgrade ofler to them in a gexxJ faidi 
effort to sidvage tlie ciustomcT rolaliorislii|i. lliey'll walk away liappy, 
Ixu they won’t forget die fad liiat diey werc inconvenienced. 

Making sure your customers receive product update 
annmmamients in a ttnxfy manner gexs ixyond notifying die 
uninformecL Rven if tiisiomers do see your latent version lusted on 
one of the software sites, they may not realise that it’s a different 
version than the one they already hiive iaqalltxl As develofxrs, we 
tend to lx very conscious of software veisiai nuinlxrs, always 
staying on top of the late's! ufxJates, Hut tramy consumers (if not 
most) don't know w^iat version of .software they are ninning, let 
alone where to even find die vcTsion numlxr. It seem.s logical 
enough to us to click the "Alxiul..." meiiLi item to find the version 
nuMilxr, liut don't foiget that we all make software for a living, so 
we have a sliglii advantage in this defianmeni. Ask an average 
consumer wliai vcrsit)n of QuickTime they have installed and more 
often lliaii not, they’ll reply, i don’t know... whatever version t:ame 
witli my iMac." 

Customei-s wlio are awarc* they only have QuickTime 5 will 
know' to upgrade to QuickTime 6 since* it is obviously a nruijor 
u[xlale. Wliere die waters get murky for mosi consumers is when 
dealing with minor releases (those mysterious second and diircl 
digits) .such as 5,0.1. So even a w'cU-inJ'omied acstomer may not 
rct:ognii^c that die latest minor maintenana" release (5.0,1) is different 
from his version Ixcause it followed so tjuickly on die hcx% of die 


Dave Wooldridge is the founder of Electric Butterfly (www,ebutterfly.com), die web de.sign and st>ftware company rc\sp>nsihte for HelpLogic, Stimulu.s, 
Uni Help, and ihe pjpular develo[x?r site, RBGafagecom. 


18 


DEHNINCJ TtlH UPGRAUI£ PaTII 


MAdtECH • Volume 20, Issue 6 











major 1.0 release he just insudled. As llic deveiopei; you tlesperately 
want liim to iasrall 1,0,1 since it fixes several bugs tJiai could prevcnl 
unnecessary lech support netiuesis and customer frustration. 

So liow do you control the information delivery to existing 
austomeis to easure dial dtey're not only awam of the latest prtxluci 
updates, hut that they know the latest version is different from die one 
they liave tnsUillcd? And if it's a pid upgrade, whafs so special alx)u[ 
it? Why should diey care enougli to sjxnd dieir haal-eamcxi money? 

An efeiive solution is to let your software application do nu>st 
of the work! Since your ciLstomers will already have your product 
installed, build a version checking feature into your apfilication that 
pericxliatlly alerts customers to new' updates when the software is 
running. Take a l<K»k at some of the applications you liave installed 
on your comfiuicr and you may find tfiai some of them already 
include this convenient feature. A [X^rfea example is Apple's 
Software Update feature tfiat's built into the Mac OS. Widijn Softwiue 
Update's preferences, you can ,set ht>w often Apple's servers are 
checked to find updates for any of die Apple software you cunently 
have iastalled. Any new updates iiie displayed in a window list, 
ready for you to clownkxid. Seleti an item and a brief clescripikin of 
the update is dlspltryed in a field Ix-'low. Cheek tlie Ixjxes of the 
software you mini dien click die "^lastaJl” button, imd your Mac- 
does die rest, seiimkrssly updating your iastalled applicatioas. ft's a 
shame that Apple lias ncv'cr opened up Software Update to third- 
pny developers - iniiigine how automated your life would lx: if 
Softwaa Update alst> updated all nf’youraimmercial and shareware 
applicatioas, Ikil ivca^aiing yrmr own implementation of Software 
Upebte widiin your pnxJucts is aaually mx as compliciiied as ii 
might sound 


BiTiDiNG Your Owin ViacsiON Checker 
O n Mac^ OS X, the most intuitive and ]X>pular placx^ to [xrt your 
"Software lJ|xJaies" menu item is either in your Help menu (see 
Figure 1) or in your Apfilioitiofi menu (lx:neath Trefemnc'es’*), 
Don't feel oblig^rted to use the phrase “Software Ujxiate." Many 
apfiliaitioiLs use TJicx'k for Llpdites," "Check ibr Upgrades,** or 
some similar variation. 


View 


Help 



HetpLogic Help 
Online Support 
E-mail News 


^dd Topic 


Software Updates 





9n.html 

n^nts. hrm! 


Get More Plugins 
Register HeipLogic 



fifiure L Mosi Mac OS X det^eloperspiace (h(^ "Softn^are 
Updates'" menu ikm in rntber the Help menu or the 
Application menu (lyenealb 'Vrefertmcesl. 


in order for your software application to check your web 
.server for new versions, it obviously requires the user to have 
an active Interne* connection. Even though roughly 4Wt) of 
Intemet-enabled Americans have broadband connections that 
are alw'ays **on,” you don't want to lie insemsiiive to those users 
who are still using dial-up connections or do not have online 
access wdien they launch your applic^aiion (such as a laptop 
owner on an airplane). If someone selecis your “.Software 
Updates** menu item, the most considerate ap]iroacli is to 
dis[i]ay a window with a ''Check Online for Llpcbtes" button, 
giving them fair warning that this feature rec|LEires an active 
Internet connection (see Figure 2). 

The more atiLomated approacii is to ctxle your application 
to silently check for an active Internet c'onneciif>n every time it 
is laimclied. If a connection is found, then yoLir a[>ptieation can 

t] iiery your web site and automatically notify the user that a new 

u] xlate is available. If a eonneciion cannoi be found, then a 
dkilog mes,sage Is displayed C'Would you like to check online for 
new sciftware iipdate.s?"), giving the user an option to either 
(Cancel or Conlinuc. Automalically aitempiing lo connect to the 
Internet without first asking for llie user’s "consenC can irritate 
some users, which is not the desired reactian you're aiming for 
when a built-in version checker is siippo.sed to improve their 
software experience, not hatn|K.“r ii. 




Figttre 2. Our HeipLogic appUcatkm employs a i}assiw 
approach, providing a Imllon thal df)es nothing hut 
check online for netv tfersiom. If a new tmyion is 
found lasers can doamload the latest uf)date at 
their contmtwnce by clicking Ihe ufeh sile Imikm. 
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Figure 3 Figure 4 show real world examples of this 
automated approach. Aladdin Systems' Snifflt Expander checks 
tor an Interne! c'onneciion when launched and 11' a new version 
is avaiJal)le, the utility displays tiie dialog message in Figure 5 
after unstuffing an archive. For promoting new paid upgrades 
to registered BBEdii customers, Bare Bones Software 
periodically displays tlie dialog message in Figure 4 within its 
popular text editor 



figure 3L for thrjse users uitb an actiw inlernet amneclkm, 
Aiadtiin Systems' StuJplExfyancier will announce the 
avaiiahiiily of new updates after unstuffing an archim^. 

The imi’jortant thing to remember is that all of these 
version checking examples inform existing customers of new^ 
updates without forcing them to download them. I'hese built- 
in dialog windows usually incki<ie a ’"Download" or ""More 
Info'' hutton (hatj when voluntarily clicked^ either downloads 
the new version or sends the user to the official product web 
page online. 

Another convenient option is to include a button that allows 
users to disable the version t:fiecking feature. Pop-up wittdows 
are annoying to many people, so even though you are providing 
tliem wiilt fielpful information, including a ""Disable” hutton is a 
nice touch. Kven if you ust^ an automated approach, you sliould 
still inc lude a ^SofIware Updates” menu item in your application 
so tha! users can check for new upc^lates at any time. 'ITits is 
especially important if a user decides to turn off the automatic 
version checking by clicking tlie "Disiible” button. Having the 
"“Software Updates" menu item available gives them a way to still 
access this valuable feature. 



figure 4 If a new paid upgrade is mmlahle. Bare Bones 
Software’s BBhdii gitm customers the option to readafxmt it 
online (More Info) ordisahie this automated notification 
(Skip Version) or simply close the uHndow (Not Now). 


So bewond tlie interface considerations of yoitr built-in 
version checker, once an existing Internet connection is found 
or a new one is established, your application can then grab 
the latest verskm data from your web site. You can store the 
data on your server in a simple ASCII text file or an XML file, 
whichever you prefer. There is no set standard for this kind of 
version checking, although using an XML-based file will 
provide greater flexibility when attempting to read and parse 
more than one string of data, such as your version numl>er, 
release notes, list of new features, status of update (free or 
paid upgrade), etc. 

With the immense popularity of XML, if your favorite 
progmmming language tloes noi include fxiiti-in supjxirt for XML 
parsing, there’s no shortage of code snippets and tutorials available 
online to help you with tliis task. Erolxibly the mosi important 
factor is the design of your XML ikKUment. You necxl to establish 
an XML format that allows you to add additional tags in the future 
(if needed), yet rcmiain lrackward<onipatible with older prcxlucts 
diat can only parse the first veiston of your XML file. 

Here's where things get inlcresting... You could build 
your own simplistic XML fonnat for storing the latest version 
number, release notes, etc., but why reinvent the wheel 
when you can kill two birds with one stone? In previous 
issues, weVe discussed listing your product with online 
software sites sucli as VersionTracker, MacUpdate, and 
MacShareware.net, While many of these Mac-relaled sites still 
require you to manually submit this inftjrmation via web 
forms, MacShareware.nei has tTcated a new updating format 
called MaePAD. PAD, which .stands for Portable Application 
Description, wnis created by the A.ssQciatron of Shareware 
Professionals ( hTtp://www.asp'Shareware.org/pad/) and has 
IxH'ome a standard medianism for Windows developers to 
easily submit/update their listings on many Windows-based 
software sites. Instead of filling out a lengthy web form, 
these PAD-enabled Windows sites simply ask for the UHL of 
your software’s PAD file (located on your web server). PAD 
is an XML-based format that incktdes rags for all the usual 
data one might expect to deliver like product name, 
description, system requirements, release notes, version 
number, and more. 'I he founders of MacSharewarc.net (and 
other contributing Mac developers) tliought the PAD format 
included too many redundant and unnecessary fields that 
were not applicabie to the Mac world, so they decided to 
modify the PAD format to be more Mac-centric. Hence, the 
new MaePAD formal wa.s born. Since MaePAD was developed 
as an open standard, other Mac software sites beyond 
MacSharew^are.net are being encouraged to use the format. 
Since you should be creating your own MaePAD file for 
subiniiting your software to MacShareware.net, why not 
simply use the same MaePAD file for your built-in version 
checking feamre? 

MaePAD is an XML-based format tliat u.ses the Mac OS 
pro[>erty list file extension (.plist). Creating a MaePAD file is 
extremely easy, Simply download Mac'Share-ware.net's SDK from 
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Effective source code control and defect tracking require powerful, 
flexible, and easy-to-use tools—Surround SCM and TestTrack Pro 


• Complete source code control with private 
workspaces, automatic merging, role-based 
security, and more 

• Comprehensive defect management — track 
bug reports and change requests, define 
workflow, customize fields 

• Fast and secure remote access to your source 
files and defects — work from anywhere 

• Advanced branching simplifies managing 
multiple versions of your products 


* Link code changes with defects and change 
requests — know who changed what, when, 
and why 

* Scalable and reliable cross-platform, 
client/server solutions support Mac OS X, 
Windows, Linux, and Solaris 

* Exchange data using XML and ODBC, extend 
and automate with SOAP support 

* Licenses priced to fit your budget 


Seapine Software Product Lifecycle Management 
Award winning, easy-to-use software development tools 


>L'jpinc 

Surround 5C/M 
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TestTrack 
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Download Surround SCM 
and TestTrack Pro at 
www.seapine,com 
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http://www-macsh3reware.net/sdk.html. Included in the SDK is a Mac 
application called MacPAD that presents you with a simple form. 
All you have to do is fill oui the form and click save and die 
applirjiion outputs your MacPAD file. Tlie SDK inclucies 
complete documentation on MacPAD's template, bm here are 
the specific XMl. fields tiiat you might want your version checker 
to parse: product Version, productDownloadURL, 

prod uc tDeseShort, produc tRe 1 ea se N oies, file Rel ea se Da i e iVI, 
fileReleaseDaieD, and fileReleaseDaicY. 

Once ycjur MacPAD 111c is finishes^, upload it to a jxrmaiicni 
location on your site such as http://www,mycompany.com/myproduct.plist. 
Now you're ready to liegin resting your version chetiker cxxic with 
your new MacPAD tile. 

In ytjur application code, you could compare the 
installed version mimber with the MacPAD version numircr to 
determine if the user has the most recent update, (>ut that may 
be more complicated than it needs lo be. Comparing miiitiple 
decimals (such as 5.0.2 versus 5.0.3) may be trivial enough, 
but don't forget about alpha and beta versions. Your code 
would need lo be smart enougli to differentiate lietwecn 
5.0.3bl and 5.().3b2. 

<kcy>prfjduetVeralon</key> 

<string>5»t). IbK/st ring? 

While comparing the two version numbers can certainly 
be done, don't waste your precious lime when the MacPAD 
formal includes three wonderful release date fields for day, 
month, and year. 

<key> fi1eR e1e a E eDateD</key > 

<strlng>l9</strtng> 

<key>flleKeleaseDa t cM</key? 

<string>04</string? 

<key>fiieReieaseDateY</key> 

<striEg,>2004</string> 

If you save the release date as constants in your 
application, then your version checking code can simply 
compare the insialled version's release date with the MacPAD 
file's release date. If your MacPAD file boasts a more recent 
release date, then that proves the currently installed 
application is not the latest version, so your version checker 
can notify tlie user accordingly. 

To Patch or Replace 

Knowing how you [)!ari on delivering product updates 
may alTecl how you compile and distribute your application, 
so it's best to have a strategy in place ludV>re the first version 
is relea.sed. On Mac OS X, if your application bundle .stores 
a lot of user support files inside the bundle, then dragging 
the bundle to the trash and replacing ii with a new version 
may cause that customized data to be lost. To avoid this 
problem, many developers use installers to “patch" the 
existing application bundle, updating/replacing only specific 
embedded components, leaving all other data imtoiu hed. 
While, this strategy may work fine for large, trusted 


tympanies such as Adobe or Microsoft, consumers may be 
wary to use an installer from a small, independefit shareware 
developer. If your application requires components to be 
installed in several places in «jrder to run, then an installer is 
your only option, but tf your application can be installed by 
simply copying it to a user's hard drive, then an installer is 
probably overkill. Mac OS X disk images make it easy for 
users to safely drag an application or folder from the disk 
image to their "Applications" folder without worrying about 
installer mishaps. With this in mind, if your application needs 
to save user resources and support files, save them in the 
user's "Documents" folder 'I'his way, your customers can 
easily replace their installed version with your latest update 
walhoul fear of installers and without fear of losing their 
support files. 

YOtJH UPtwRADE STHAJ'EGV 

Define a system for determining which update^i will reciutre 
paid upgrades and which ufxlates will be provided lo registered 
customers for free. Most commercial developers set aU major 
version numlx.*rs as paid upgrades (such as 4.0, 45, 5.0), while 
minor releases typically indicate free maintenance releases for 
improvements and bug fixes (such as 5.2 and 5.2.1). If you set 
this kind of pattern into place, your customers will expect you 
lo follow it. No one likes surprises and customers certainly don’t 
like feeling tbit their loyalty is being exploited witir excessive or 
unexpected paid upgrack-s. 

It's typically a gootl idea to add the key-selling features 
to your major version releases, t his way, your customers will 
feel that paying tor the upgrade is a worthwliile expenditure, 
if you continuously add cool new fealiires to your free minor 
updates, it devalues your paid upgrade releases. For 
example, if the free 5.2 and 5.3 updates each included four 
new Features, and yet the 6.0 paid upgrade only includes 
three new features, customers are going to question the 
upgrade price. It doesn't matter that programming all of 
those free feanires devoured a lot of your time. Consumer.s 
typically don’t amorlize an u()grade price by factoring in all 
of the Free minor releases they already received, in their 
eyes, many will fin<i it har<l to justify spending money on 
three new features when they’re used to receiving dozens of 
new features lor free in pieviou.s updates. Use your minor 
releases for issuing bug fixes and performance 
enhancements, while saving your Ihg feature attractions for 
your major version paid ujigradCnS, 

After finalizing the feature .set for your prodtici's first 1.0 
release, there will obviously be features that are left for 
inclusion in future versions (not to mention new feature 
ret|uesis that your customers will submit). Be c'xtreful to spread 
out new features over the course of several versions In order 
to provide a healthy upgrade path and lifecycle for your 
product. This is a precarious iialance since you w^ani every 
major new version to contain the right feature sets to satisfy 
user demands and effectively compete with other products. 
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but if you pour everything l)ul llie kiichen sink into version 
2-Oj you run the risk of the “feature weir running dry for 
version 3-0, leaving each successive release appear lacklusien 
The trick is to exceed expectations with each major new 
release without setting a precedence so iiigli that suhsec]uem 
versions fall short in the eyes of custotners and reviewers. 

Reward Loyal CifS'rOMERs 

Tile last facior to consider when plarining your upgrade 
strategy is [jrice. It's imponani to remember that happy 
customers remain loyal customers. If they are satisfied with 
y(mr prt)ducf, then odds are, they will be very interested In 
upgrading to new versions. The nice thing about selling to 
your customer )>ase is that, unlike potential new customers, 
existing customers are already hooked on your software. If 
you've done your job right (providing excellent customer 
service and support), then tamvincing loyal customers to 
upgrade to the latest version does not lake nearly the amount 
of cfforl ihai ii takes to successfully market your product to 
newcomers. So don't abuse this amaxing relationship. Reward 
your customers’ loyalty with cosKTfective upgrade prices that 
tjuickly m<aivate them to purchase. Upgrade prices should be 
enuugli of a discount from the full price that people consider 
their status as a longtitne customer to be a significant benefit 
with each new release. 

Since customers already kive a working version of your 
software itistalled, upgrading tt> the latest version m^iy get 
delayed indefinitely due to busy work lives and general 
prcxrastination. Give them an incentive to upgrade stxmer rather 
than later by offering a limited time prirmotion. Some software 
companies offer a special upgrade jjrice that is even less than 
the usual upgrade price, while others throw in free lK)nus 


software as an incentive. Tlic key is to place a time limit on the 
special offer, so that after a cenain date, CLusujmers will be forced 
to pay the usual upgrade price. Tliis is where your MaePAD file 
and built-in version checking feature can really help you. If you 
place die upgmde offer tn the pn>ductReieast*Notes XML field, 
then your version chec'king code can parse and display this 
infonnation witliin your applinition when it notifies customers 
that a new^ paid upgrade is availafjle. 

<key >prod uc tRel eases NotesC/key) 

^String)'nie new 5.0 Innliides more then 
UO nev features for only S&9 h 95, For a 
limited time only, registered customers 
can upgrade for only 519.95 (regularly 
$29.95 after June I, 2004).^/string) 

'litis may not be exactly w'hat the MaePAP founders had in 
mind when they defined this paiticular XML field, but since 
you're utilizing the Mact^AD format to support two sejxsrale 
needs here, it's up to you to squeeze every p)s.sible benefit from 
tliis tec’hnology to l>est serve not only the Mac communttyj but 
also your own marketing effons and customers. 

Stay in Touai 

Maintaining a sia>ng relationship with your custo!iiers Ls an 
imptmant step to a long and profitable prtKiuct lifecycle. By 
t'ominunianing througli your sofnvare, you can stay connected 
with your customers without having to send a barrage of e-mails. 
And rewarding customer loyally with spedd upgrade prices and 
oflier benefit.s will e;irn theff devotion and respect. Happy 
customers will recommend your software to tlieir friends, family, 
and co-workers. Take cure of your customers and in return, they 
will lake care of you. 
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Object-Relational SQI^ Database 


The fastest database engine 
for MacOS/Windows 


It operates lUO's and sometimes 
a 1000 times faster than other systems 

www.paradiginasoft.com 

Hosted by macservc.net 

Download fuU featured evaluation version 
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QUICKTIME 

TOOLKIT 


by Tim Monroe 

Tickle Me 


Developing QuickTime Applications 
with Tcl/Tk 


INIHODUCIION 

Tct/Tk is a CQinbimtk)n of two distinct elements^ 7b/, whicfi 
is a string-onented scripting language and nmiime li[3rary, and 
Ik, which is a tfiolkit for consimcling gmpliical user interfaces. 
Tliese elements were designed and impieinented more or les.s 
concurrently at U.C. llerkeley beginning in I9H8 l>y a team k-d 
by John Oysterhoiit. His goal was uj dcvek)p an exteasible 
language that various software tools could use to control the 
execution and processing of commands, Indeed, ‘"Tcf is an 
acronym for Tool Command language (and is usually 
pronounced “tickle”). 

One distinctive feature of Tcl/Tk — at least compared with 
the development environments we've consitlered in the jrast 
dozen articles — is that its sourtx" code is puldicly available and 
largely free of restrictions on its use. This has several important 
consequences. First, it means that 'IcI can easily lxi emlxxldetl 
into an existing application to provide a scripting inierface ibr 
that application^ if neces,sary, Tk can also be eiiilx*dded into that 
application to provide a grapliical user interlace. Second, it 
means that new capabilities can easily be added to Tcl and Tk by 
defining new commands anil GUI objecLs. For present purpases, 
well lx* intert*sted in a Tcl/Tk add-on called QuickTimeTd, 
witich allows us to work with QuickTime movies in a Tcl/Tk 
applicrtion, QuickTimeTcl is also freely available and am be 
incorporated into commercial and non-commercial prcxluas. 

In tJiis article and the next, I want to take a look at using 
Tcl/'l'k and QuickTimeTcl to develop Quick!niie applications. 
We'll c:onsinjcl an application, called Itckleez, that can open, 
display, edit, and play one or more QuickTime movies, wliile 
pennitting all the siantlard sorts of user interaction. In this first 
article, we'll Ixgin wiiii an overview look at TTc, and 
QuickTimeTcl. 'fhen well see how to start tip a Tcl/Tk 
application, how to cons!met and handle our application’s 
menus, how to display dialog lx>xes, and how^ to open a 
QuickTime movie in a window. In the next article, well 


continue our invesiigaLion by seeing liow to handle movie 
editing and dcxument-related tasks. 

Ail three important elements — Td, Tk, and QuickTuneTcl 
— are available for lK>ih Macintash and Windowrs operating 
systems. We'll write our application script so ikil it is aware of the 
cjjx^ratmg environment and liehaves appropriately on each 
platform. As we .saw in our previous arik'les on QuickTime for 
Java (in January, Februaiy, and March 2004), this mainly 

involvc^s making sure tliat the menus are arranged correctly (for 
iastance, putting the Quit menu item in the File menu on 
Windows ami in the Application menu on Mac OI? X). lliere are 
also several other tiiinor issues that require different trearment on 
each operating system. On the whole, however, well see that Tk, 
like Java’s AW!' and Swing, provides a very usable platfonrt- 
independent graphical toolkit that allows us to saipt user 
interlace ol>iects widi little or no concern as to whether they are 
Ixnng displayed on Mac or Windows t'OJtipuiers. 

Tcl Overview 

As ulraidy noted, Tcl is a scripting language used by imh 
for processing commands. Tci is refresfiingly simple and 
readai>le, particularly wlicn compared with other popular 
scripitng languages (for instance, Ferl). It’s a procedural language 
that has a predominately C-like syntax. Tcl does not provide any 
object-oriented primitives, but tliere is an objecPoriented 
exteasion tjf Td, called “liner tclj", (Youll lairn shortly whal die 
name signifies.) In these articles, well Ix! ctmteni to work with 
standard Tci. 

Getting Started 

A Tcl script is a series of one or more commands, each of 
which has tills structure: 

connnmid m-}^uments 

Tile numl>er of arguments is detenninetl by the specific 
command. For instance, wc can i>riut the phrase “hello, world” 
with this line of script: 


Tim Manroe Ls a juember of the (^uickl'ime engineering teani at Apple. Yoii can contact him at morrO€@niaaecli.com. Hie views expressed here arc 
not necessarily shared by hi.s employer 
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If a picture is worth a thousand words, 
imagine how priceless a movie would be. 



Snapz Pro X 2.0 allows you to effortlessly record anything on your screen, saving it as a QuickTime® 
movie that can be emailed, put up on the web, or passed around however you please. 
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Why take a static screenshot when Snapz Pro X 2.0 makes creating a movie just as easy? 
Snapz Pro X 2.0 does that, and so much more - what a difference a version makes! 
Download a free demo version from our web site today and see for yourself: 

http://www.AmbrosiaSW.conn/ 


Snapz Pro X 2.0 

AMBROSIA* 

SOFTWARE INC 

Snapz Pro X, Ambrosia Software, Inc., and the Ambrosia Software logo are registered trademarks of Ambrosia Software, Inc. 

















































puts stdout world'" 

Here ''puts" is the coinrriand, and "stdout" and "hello^ world" are 
llic two arguments for the conunand. Notice that the second 
argument is the entire 12-characier sting enclosed by the 
quotation marks (“*). 

We can assign a value to a variable using tlie set command, 
and we can read a variable's cmrcTit value by prefixing the $ 
character For instance: 

fset message “hello, world** 
putfi stdout $message 

These two lines paxluce exactly the same output as the single 
line sJiown above. 

We can prevent substiluiitm of variable values by prefixing 
the $ character with a liacksfash: 

puts stdout \$ii)es£3ge 

Tliis will produce the output “$message”. Alternatively, we 
can use braces to delimit arguments whose variables are not 
to be substituted: 

puts stdout 

Once again, this will produce the output “$message’\ 

Braces can also used to delimit the names of variables wlien 
the variable name is eml')edded within a longer string. For instance: 

puts stdout $imessageillng 

This will produce the outpiii iiello, worldling’'. 

Evaluating Cosnniands 

A command occurring by itself on a line is evaluated and 
any value tlic command produces is returned as the command 
result. It's also possible to nest commands on a single line, using 
brackets. Here's an example: 

sei X [expr [winfo screenwidth .myWindow]/2 - l&O] 

Here we call two nested e()mjnands, winfo (a Tk command that 
retrieves tlie S[)€cified information about a window, in this 
case the width of the screen that contams the window 
.myWindow) and expr (a Tel command that evaluates the 
expression passed to it). Once this command line is executed, 
the variable x will contain the horizontal position at which we 
should position a window that is 360 pixels wide if we want 
to center it on die screen* 

Tcl provides a large number of built"jn commands. We've 
already encountered the set, puts, and expr commands. A 
handful of additional Tci commands are unset, if, while, switch, 
array, and return. The incr command increments the value of a 
variable by a specified amount, or by 1 if no amount is specified. 


'Ihtis, if the value of die variable xyz is 10, then the following 
command will set the value of xyz to 11: 

incr xyz 

In Tcl, any built-in commands c:an be redefined. In die 
following article, well need to redefine the built-in command 
exit to allow TickLeez a chance to clean up before the 
application terminates. 

Defining Procedures 

We can define pixx:edures in Td using the proc command. 
The general form of a proc:etlure definition is this: 

proc name {ar^utnents} {commands} 

For instance, listing 1 defines two pnxxtlures, min and max, which 
return the .smaller or laiger of the two values passed in as arguments. 

Listing 1: Getting fflregtcf lesser values 

mx.mia 

proc max ta bl [ 

if |$a > $bl {set at else I set bl 
I 

proc nin U bl I 

if |$a < $bl Isrot a I else [set bl 

I 

Notice that the argument list is enclosed in braces, to delay 
evaluation of die arguments until die procedure is called. Notice 
also lliat a value is returned to the caller as the side effect of 
executing the set command. (A pRKredure’s return value is die 
return value of the last command executed in the procedure.) 
We could ju.st as easily write the min procedure like this, which 
uses the return command: 

proc ttiln Ea bl f 

if ISa ^ ^bl [return $ol else [return Sbl 

1 

I’here is one final item to keep in mind: there must be a 
space following the right bntce that encloses the argument list; 
otherwise the Tcl interpreter will complain that there are extra 
charaaers after the closing brace. 

Using Structured Data 

Ihe h£Lsic data type in Tcl is die string; all arguments are 
pa.s.sed as strings, although certain commands (for instance incr) 
may interpret their input numerically. Td also provides two ways 
to combine strings into slruclures: lists and arrays. A list is 
roughly ec]uivalent to a string whose elements are separated 
from one another by white space. Td provides a large number 
of commands to create and operate on lists, including list, (index, 
(length, lappend, concat, and split, list indices sran at 0; the word 
end can 1^ used to pick out the last element in a list. 

For large collections of data elements, it's often easier to use 
an array, which is a variable whose values are addressed using 
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a string index. (Tcl arrays are also called msociative armp, 
clictionaries, or hashes.) In ’rickleez, we will employ array-s 
extensively. In paftic:ular, we will store six pieces of global 
application data in an array called appData. The array element 
appData(winNo) will contain the number of the next window to 
open; we'll use this information to construa a imiqiie internal 
name that identifies tliai window. The array element 
appData(nextNewWinNo) will contain the number of the next new 
window to open; we’ll use this intbrmation to coastruct a movie 
name of the form ‘"IlniitledTJ.mov", Tlie array element 
appData(os) will contain a string that identifies tlie current 
operating system. The an'ay element appData(modKey) will 
contain the name of the OS-spedfic modifier key (namely, either 
“Command" or “Control"). Tlie array ciemeni appData(winTag) 
will contain a unique tag we use to constixict the names of our 
movie windows. Finally, the array element appData(tempDir) will 
contain die full pathname of a directory that holds any 
temporary files we need to create. 

We'll also need to associate some data with each movie 
window' that we open. For instance, well need to maintain 
information atout the movie contained in a window, such as its 
edited state or the pathname of the file it was loaded from. 
Unfonunatcly, Tk dtKts nol provide a standard means to attach 
a list or array to a specific window (as we could do using the 
functions SetWRefCon and SetWindowLong in our Cdoased 
applications), Wc can work around this limitation by storing that 
data in the appDala global associative array using array indices 
that contain the window's name. For instance, if die winName 
variable c:onLains ihe name of a specific window, then we can 
use the string "$winName.fileName" as an index into the appData 
array; the value associated with that index is die full pailinamc 
of the movie file. 

We'il use diis little trick to store five pieces of informiition 
in the appData array for each open movie. Tlie army element 
appDala($winName,movie) will contain the (^uickTimeTcl 
identifier for the movie. The array element 
appData($winName,dirty) will contain die cliaracter “1“ or “0'', 
indicating whether the movie has been edited or not. The an-ay 
clement appData($winName,undoLevel) will coniain the undo 
level for the movie (dial is, the numlier of undoaiile cdiLs tliat 
have been applied to the movie). Finally, the anay element 
appData($winlMame,undoOp,;'?) will contain a siring indicating 
which edit operation was applied a die undo level n. Well use 
that string to set the text of the Undo menu item, as well see in 
the next article. 

In order for die elements of the appData a^ssoeiative array to 
be visible througliout our application, we need to include die 
folkiwing line at the beginning of any procedure that accesses 
the data in that array: 

global appData 

Note tliiit we could have used individual variable names for die 
six pieces of global application data; by collecting tlieni all into 


one array, we reduce the number of global statements we need 
to use in each procedure. 

Tk OvTmiEW' 

Tk (short for “Tcxilkir and u.siially pronounced “tee-kay”) is 
a toolkit for construaing graphical user interfaces. We can use it 
to create and display the windows, alert Ixixes, dialog lx>xes, 
menus, and other visible elements of our applianion. Moreover, 
Tk handies events and user actions involving the elements in 
those windows, dialog boxes, and menus. In other words, it 
provides evenl-dnven control flow' for our applications. 
Originally Tk was designed to work in conjunt'iion with the X 
Windowing System, but subsequently it has licen modified to 
support other graphical user interface systems, including those 
on Mac OS and Wmdows. On Mac: OS X, Tk uses the Aqua 
interface, although it currently has a few drawing and event- 
handling glitches. 

Creating Windows 

In lie parlance, a mdget is any visible user interface 
element. In TickTjeex, well be mainly concernetl with tliree 
kinds of widgeLs: windows, menus, and movies. It's very easy to 
create a new w^indow. Here’s part of the code we'll use lo create 
our application's About box: 

tOplevel ,about -width 360 -height 160 

Tlic toplevel command creates a new toplevel window, in this 
case one that is 360 by 160 pixels. Tlie first argument to die 
toplevel command is the name of ihe new window. In Tk, 
widgcLs are arranged in a hierarchy, the rcxit of which is a 
toplevel window whose name is All new widgeLs must have 
names that are relative to some existing widget. In particular, all 
widgets miisi Ix^gin with the cfuiracter. As you can see, the 
name of our About box Ls “.about". 

The names of windows are reasonably ati>itrary, as long as 
iliey too begin with the character. To make it easy to find all 
and only die movie windows, let’s give all our movie windows 
names of die form “.winRTMrT, for some integer n. So the first 
movie window we create will have the name “.winRTMl”; the 
second will Ix:^ “.winRTM2", and so on. As noted earlier, the array 
element appData(winNo) liolds the next available window 
number, so we can generate a movie window name like this: 

set winKamis SappData(winT,'^g) (f ncr appDats{wfnNo)] 

Based on this naming sc:heme, we can tell whether a given 
window^ is a movie window l>y passing iLs name to die 
isMovieWindow procedure, shown in Listing 2. isMovieWindow 
just ItKik.s to see whether the winName argument begins with the 
string "winRTM”. 

listing 2; Finding tnovk w indows _ 

bMovicWiiKlow 

prQc: IsSt) vie Window IwinNaniel ( 
global appData 
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Get more out of your Macintosh! 

DevDepot sells the tools, toys and technology to put more muscle into your Mac. Innovative 
upgrades, essential accessories, and cutting edge new products for those of you who just want more. 

Visit the Official Store, managed by DevDepot, for show speciols and great new products from 

all over the show floor! 

DevDepot has it all! 





500 GB on your Desktop 

The BigDrive from LaCie, FireWire 800 
and all the capacity you can ask for. 



Put 80 GB in your PowerBook 

Why leave if behind? Keep all the data 
and applications youneed on your 
PowerBook or iBook. 



Add a SuperDrive 

An internal SuperDrive does it all - 
DVD-R/RW and CD-R/RW in one drive. 
iDVD compatible, 
easily to install. 



Lucid FireWire Powered 
CD-R/DVD-R 

Lucid CD-R/RW and DVD-R/RW 
drives ore ITunes compatible and t 
powered. Portable and Powerfulll 



PowerWave USB Amp 

Audio interface and amplifier 
for your Mac or PC, connect 
your home speakers or sound 
system to your USB Mac. 


Noise Reduction 
Headphones 

With airline adapter, the perfect 
companion for iPod and 
traveling with your PowerBook. 













HARMONi for iMoc 

Pump your original iMoc to 600 
MHz G4 and add FireWire! 



Macintosh RAM 

RAM upgrades at great prices, designed and 
built For best perFormance and 100% 
compatibility with your Macintosh. 




Wallsfreet G4 

Your Waltstreet G3 PowerBook can 
have a 500 MHz G4 Processor! 


G4 Upgrades 

Put up to a 1.2 GHz G4 in your 
box. Upgrades for your G4 Tower, 
your iMoc, Blue & White, Beige G3, 
8500 and before! 



PowerMate Analog Control 

Control iTunes or DVD Player, edit 
home movies or just use it next 
to your mouse as the 'ultimate' 
scroll wheel! 



AirPort USB Adapter 

Add Airport connectivity to your [Mac, 
PowerMac or any USB Macintosh! 



Wireless Mice 

Finally a wireless mouse for Mac, 
done right! Portable version br 
PowerBook users or desktop version I 



iceCAD 

Ideal tool for Apple Ink Wei I for 
handwriting recognition, freehand 
sketches, or use with graphic 
applications. 





Replacement Batteries 

Long flight or multiple meetings, do you 
need more juice? Batteries for G3 (Pismo, 
lombard, \A/allstreet) and G4 PowerBooks! 

The PowerBook Handle 

A must have for G4 PowerBook users, put a handle 
on your PowerBook ond great to prop up your 
PowerBook for a comfortable tilt. 


iTrip 

The ultimate iPod accessory, plugs into your 
iPods FireWire and Audio ports. FM 
broadcaster, powered ond controled throug' 
your iPod. 

Better AC Adapters 

The smallest, most compact AC adapter 
for PowerBooks and iBooks. One adapter 
for home, one for the office! 







Outside US/Canada: 805'494'9797 • Fax: 805-494-9798 • orders@devdepot,com • PO Box 5200 • Westlake Villoge, CA 91359-5200 



















if I [string first $appData(^irLTag) SwinNamel = 01 i 
return I 
] else [ 
return 0 


An aUemative atracegy is to set a movie window’.s claims l)y 
including the “-class RTM” option when we create the movie 
window. In that case, tlie if line in listing 2 would look like this: 

if f [string equal [wiiifo class *$winNaniiG] RTH] 1 [ 

In a large application with many kinds of windows, using 
window classes is probably prefLTal>le. In Ticklcez, since we 
display only movie windows and tlie About box, well stick with 
the method that uses a set of special window names. 

We can find the frontmost movie window l>y calling tlie 
topMovieWindow procedure defined in listmg 3. First we create 
a list of all open toplevel windows by executing the wm 
stackorder command. Then we lotjk at each window, from top 
to ixjtumi, until wc find one that satisfies the is Movie Window 
prrx:edure. 

Listing 3: Finding the movie window 

itipMovicWitidow 

proc topMovieWindow 11 f 
global appData 

set winlist [win stackorder .1 

set index fexpr [lleugth $vinlist] - 1] 

while fI[IsMovieWindow [string range \ 

[lindex $winlist $index] 3 endl] [$index >=0)1 [ 
iucr index I 

\ 

return [string range [lindex Swinilst Slndex] 1 endj 

1 

The ca[ls to range chop off the first character of the 
specified list element (that is, If no movie windows are 
open, topMovieWindow returns an empty string. 

Creating Menu Bars and Menus 

We can use Ik to create and manage menu l>ars and 
menus, which can contain standard menu items, separator 
lines, checkbutton items, and radiobutton items. A 
checkbucton menu item toggles between two states, and 
radiobutton menu items arc organized into groups ‘iuch that 
exactly one item in tlie group is selected at any time. Menu 
items are in fact just buttons that behave in specific ways and 
that are grouped into menus. 

A menu liar is always associated with a specific toplevel 
window; this means that well need to create a menu bar and a 
set of menus for each movie window opened by TickLeez. On 
Windows computers, the menu [>ar is contained in the movie 
window itself, as shown in Figure 1. On Macintosh computers, 
the menu bar is drawn at the top of the main screen, as usual. 



QuickTime 


Figure 1:A movie mndow dispiayfed by Tickf^z (Windows) 

A menu bar is in fact itself a menu. In Tk this is known as 
a cascading menu, since the items of the menu cascade from left 
to righL We create a menu bar by executing the menu command: 

set bar [menu -tearoff 0] 

Here the variaible w is assumed to lie the full name of a window. 
So, for instance, the movie window whose name is “.winRTMl” 
would have an associated menu liar whose name is 
“.winRTMImbar", We asstxiale a menu bar with a window like this: 

$w configure menu $bar 

On Macintosh computers, we will create a tiienu f)ar and set f>f 
menus for the root window even though we hide die root 
window during application startup. This allows TickLeez to 
display a menu bar even when no movie windows are open. On 
Windows, we don't create a menu bar and ,set of menus for the 
root window; instead, wc create a new empty movie window 
(Figure 2) when the a[iplication starts up; the user can use die 
menus in that window to open movie files, (WeT see die code 
dial does all this a bit later, in Listmg 7.) 



Figure 2: A new movie window displayed 
by TickLeez (Win^ws) 
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We can atld menus lo the meny bar with the add cascade 
command* Here's how we'll create a File menu and add it lo the 
menu bar: 


accelerator "^^appOata (aodXey)-A’* \ 
cojmaaad (selectBoc all! 

$m add coiimand -Label "Select None" \ 
^accelerator "SappDataCnodKey)-B" \ 

-ctmiiiaTid ts electBoc nonel 


set m [nenu $bar.file -tearoff Oj 
$bar add cascade -label “File" -meny 


* Movie mem* 

set in [tnenu $bar*iDOvle teatoff Oj 
$bar add cascade -label “Movie" -menu Sm 


And we can add menu items to a menu with the menu's add 
command command. Here's how well add the New item to the 
File menu: 

$m add command label “New" \ 

-accelerator "$appDataCmodKey)-K" -cotmnaDd EnewDoc) 

Notice that we specify the llckLeez procedure that is to be called 
when this menu item is seleaed by using the -command argument. 

Listing 4 show die complete definition of the setupMenus 
procedure. 


$ra add command -label "Hide Controller Bar" \ 
-accelerator "SappDatafraodKey)-1“ \ 
-command Iputs “TO BK PROVIDED** 1 

* Heip menu 

if ( [string equal $appData(os) "windows "]\ 1 
set m [menu $bar*help -tearoff Oj 
$bar add cascade -label "Help" -roenu Sm 
1 else { 

set m fmenu $bar-apple -tearoff 0) 

$bar add cascade menu $tB 


$m add command -label "About TickLeez" \ 
- c otnaand E skovAbcutDox I 


listing 4; Setting up the menus a nd menu iteoLS 

proe setupMenus Iwl \ 
global appData 


jictupMcruu 


* create a new menu l>ar 

set bar [menu $iv3mbar -tearoff 0] 


» file meini 

set m [menu $bar,file -tearoff 0] 

$bar add cascade -label “File" -menu $m 


)-N" -command fnewDocl 


$m add command label “New" \ 

-accelerator “$appData(modKc 
$iit add command *labei “Open.*." 

-accelerator "$appDataCmodKeyl-0" -command topenBoc] 
$ni add command -label “Close" \ 

-accelerator “$appData(modKey]-W" -command IclosoDoc) 


$111 add sep 

$11 add comniand -label "Save" \ 

-accelerator "SappDatatmodXey)-S" -command isaveDoc) 
$11 add coBmand -label "Save As..." \ 

-accelerator "SappDataCmodKey)-Shift-S" \ 

-command f saveAsDocI 


if [[string equal $appData(os} "windows"]) I 
$m add sep 

$01 add command -label “Exit" \ 

-accelerator “SappData[modKey)-Q" -command (exit I 


Edit menu 

set m [menu $bar*cdit tearoff D] 

$bar add cascade label "Edit" -menu $m 

$11 add command -label “Undo" \ 

-accelerator "$appData{modKey)-Z“ -command tundoBocl 

$m add sap 

$m add command label "Cut" \ 

accelerator "$appData(modKsy}-X" \ 
oontmand [editDoc cut) 

Sm add command -label "Copy" \ 

-accelerator "SappData(modKey)-C" \ 

*command IeditDoc copy) 

$m add command -label "Paste" \ 

-accelerator "SappBataCmodKey) V“ \ 

-command [edit:Doc pastel 

Sm add command label "Clear" -commaud [editDoc clear I 
$m add sep 

$m add cononand -label “Select All" \ 


$w configure -menu Sbar 
J 


Wcf’ll encounter the various prcKedures attached as commands 
later on in this article and the next. 

Adding the About Box 

Let's lot)k at a real-life example of using Tk to display and 
manage a window on the screen, in this case our application's 
About box. rhe Windows version of the AlxkJt lx)x is shown in 
Figure 3, and the Macintosh version is shown in Figure 4. 



Figure 3: Ihe About box o/TickLeez (Windows) 


r<tl^O About TickUez 

A QuickTime movie player built 
with Tcl/Tk* 

e 2004 by Tim Monroe 


^ OK I 

fi^re 4: The About box ofTickLeez (Macintosh) 
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Youll notice that the appearance of the Macintosh About lx)x 
isn't quite ri^ht; Tk currently is unable to draw llie iiorizontal 
stripes lital fonn the l>ackgrouncl of an Aqua dialog box. 

The first time the user selects the About 'I’ickLeez menu item 
to display the About b<>x, well use the toplevel command to create 
a new toplevel window, as mentioned above. When the user 
closes the About box, however, we won’t destroy the window. 
Ratlier, we'll simply hide the window (by issuing the withdraw 
command); if tlie user later deddes to disq^lay die Alx>ut lx)x again, 
we can just show the liidden window with these commands: 

wm state .about normal 
raise .about 

This saves us from having to create and delete the Images in the 
About box each time it's displayed. 

Our Alxjut box contains four widgets: tlie OK button, a 
static text field, and two additional buttons. We can create and 
position the OK button with this code: 

place [button ,about.ol( text OK default active \ 
width 5 command Iwid withdraw .about II \ 

-X Z84 -y 124 

As you c'an sec, tlie command assodated with the OK button is 
to withdraw^ (tliat is, hide) the window .about, which is the 
About box itself. 

Tlic two additional hutton.s arc u.scd to display the images 
in the About ix>x. In TickLeez, the Alx)ut box is configured in 
such a way that clicking the penguin image changes that picture 
Lo the Td logo. Fig:urc 5 sliows the result of clicking the 
penguin image in Figure 4. 


© O O 


About TickLeez 


S(! 

trUtk 


A QuickTime movie player built 
withTcl/Tk. 

® 2004 by Tim Monroe 




Figure 5* 7he Ahoui box of Tickj£e 2 : (clicked) 


Toggling the two images us accomplished using the raise 
command; when passed two arguments, it causes the first image 
to be drawn on top of the second image. Since our two images 
are cleverly ctmfigured to be the same size, this causes one 
image to become visible and the other invisible. 

Listing 5 shows our complete definition of the 
showAboutBox procedure. 


Idsttog 5: Showing the About box 

proc showAboutBox fl f 
global appData 


showAlioiitBox 


# if die About box exists already, jmt show It and bring It to the fnmt 
if f [winfo exists .about]] ( 
wm state .about normal 
raise .about 
return 


* otherwise, create the About box 

toplevel .about -width 360 height 160 

wm resizable .about 0 0 
wm title .about "About TickLeez" 

If t [string match “mac*" SappData(os)11 [ 

: :tki: unsupported ; iMaeWiridovStyle style .about \ 
document IcloseBox] 

I 

place [button .about.ok -text OK -default active \ 

-width 5 -coitmiand (wm withdraw .about tj \ 

-X 2S4 -y 124 

place [label .about.what -wraplength 220 -justify left \ 
text "A QuickTime movie player built with \ 
TGl/Tk.\ii\ii\u00a9 2004 by Tin Monroe"] -x 120 -y 12 

set penguin [image create photo file \ 

[file join [pwd] penguin.jpeg]J 
set feather [image create photo -file \ 

[file join [pvd] tcl.jpeg,]] 

place [button .about.pen iiuage $penguln \ 

-width Ih -height 105 -relief flat \ 

■command "raise .about.tcl .about.pen"] -x 20 y B 

place [button .about.tcl -image $feather \ 

-width 76 -height 105 -relief flat \ 

-ooramand "raise .about.pen .about.tcl"] -x 20 -y B 

raise .about-pen .about.tcl 

bind .about <Return> about.ok flash: .about.ok Invoke) 
wm protocol .about Wtl_DEiETE_WlXD0W (.about.ok invoke] 

# center the About box on the screen 

set X [expr fwinfo screenwidth .about]/2 - 180] 
set y [expr [winfo screetihelght .about]/2 - 80] 
wm geom .about +$x-t$y 


We can load the penguin image like this: 

set penguin [image create photo -file \ 

[file join [pwdj penguin.jpeg]J 

And we create and position the button like this: 

place [button .about.pen -image $penguin \ 

-width 76 -height 105 ‘relief flat \ 

-cotumand "raise .about, tcl .about .pen"] -x 20 -y 8 


Notice that Keairn key pre.sses and clicks in the window’s 
close lx>x are configured Lo have the same effect as pressing the 
OK button. 

We have laid out the widgets in this dialog box using the 
place command, by specifying item positions in terms of 
absolute coordinates in the dialog box. Here we are using 
the place geomerry manager I'k also provides the pack 
geometry manager^ which lays out items in frames, which 
can be grouped and positioned relative to other frames. For 
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complex widget posiiicming, the pack geomeLry manager is 
virtually always preferred. Indeed, using the place geometry 
manager with explicit coordinates is generally considered 
bad practice. We can get away with using it here because our 
About box is so simple. 

QiicicTiMF.Ta. Overview 

QuickTimeTcl us an extension to Td/Tk that we can use to 
open, display, and modify QuickTime movies. It was originally 
written by Bruce O'Neeh and has subsequently been 
significantly enhanced and extended by Mats Bengtsson. 
QuickTimeTcl supports QuickTime movie playback and editing 
on all three major platforms currently supported by Quicklime: 
classic Mac OS 8 and 9» Mac OS X, and Windows. 

QuickTimeTcl extends Tcl/Tk by defining two new widgets, 
movie and seqgrabber, which support movie playback and 
editing, and audiovisual capture. In addition, QuickTimeTcl 
supports a handful of other commands dial provide information 
or supplementary capabilities: for instance, it supports the 
funaion tk_getOpenFilePreview, which extends the Tk fumnion 
tk_getOpenFile by adding a file preview to die file-opening 
dialog ix>x and by automatically restricting the selectable file,s to 
those that can be opened by Quickl ime. Here's how easy it is 
to open a file using QuickTimeTcl: 

package require QuickTimeTcl 
iset filename [tk_getOpenFi] ePrevlew] 
mevie .m file $filGname 
pack .&t 


We indicate that the QuickTimeTcl package is required; we elicit 
a filename from die user; we configure a movie object in the 
root window; and then we pack the movie widget into the root 
window. Since the movie is the only widget In the window, the 
window is sixed to exactly hold the movie, 

QuickTimeTcl is a reasonably complete TcLTk wrapper for 
the most common Quicklime APIs. It provides support for 
movie editing, importing and exponing, applying video effecLs 
to movies and images, displaying movies full screen, and 
creating movies from a series of images. QuickTimeTcl also 
provides a mechanism to intercept and monitor a large number 
of messages passed to die QuickTime movie controller, 
including notifications of key events, custom burton clicks, time 
and volume changes, mouse button dicks, selection changes, 
and (for QuickTime VK movies) clianges in die pan, tilt, or field 
of view angles. This mechanism stands in for several of 
Quicklime's callback procedures, in particular for the mtivie 
controller action filter prticedure. 

If we need to extend QuickTimeTcl to support capabilities 
that it does not currently provide (for instance, support for 
intermovie communication), we am download and modify die 
source code, which is freely available. The QuickTinieTd 
extension is written in fairly vanilla C, and indeed relies in pan 
on some of the sample code weVe considered earlier in diis 
QuickTime Tooikil series of articles. For instance, Listing 6 


shows the roudne that QuickTimelcl uses to determine the 
height of the movie controller bar 


Listing 6: Finding the height of the controiler bar 

(rctComroUtnitarUdglu 

short GetControllerBarHeight (MovleControiler me) 

I 

Boolean wasAttached " false; 

Rect myRect; 

short layBeight “ Or 

r tf the contoiller bar is attadicU, dciudi ii (and ttmeuiiXT we did so) V 
if (HGIsCcintrollerAttaohod(Bsc) “ 1) I 
wasAttsched = true; 

NCSotControllcrAttacbed(me, false); 

I 


r tkt ihe rcetangk of die coniroller 7 
KCGetControllerBcundfiRect {ac, SiinyRect): 
myHeight ^ myRect.bottom - myRect.top; 

t Now reattach the controller bar. if It was ciriginally aiudied 7 
if (wasAttached) [ 

MCSetControllerAttached(me, iruo); 

» 

returnCmyEeight): 

I 

If you have a good memory, you may recognize this as a 
slightly modified version of the function 
QTUtils_GetControlterBarHetght that we encountered in the article 
"Movie Controiler Potpourri” {MacTeeb, February 2000), 
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Note that QuickTimeTcl can also be used as a pure scripting 
tool, with no user interface. This would allow us, for instance^ 
to use Tcl scripts to automate various movie operatic)ns> such as 
creating a movie from a series of images or transcoding existing 
movies into new formats. In these articles, we will not 
investigate this way of using QuickTimeTcl. 

Appucation Startup 

Let’s get started writing TickLeez, which we want to be able 
to open and display QuickTime movies, allow the user to edit 
those movies, and exhibit all the standard document-related 
behaviors. The TickLeez script begins with the “package require 
QuickTimeTcf’ directive considered earlier. Then it defines several 
dozen procedures and ends with this command: 

Btain 

Our main procedure performs launch-time initializations 
and adds the six pieces of global information to the appData 
array. Listing 7 shows our implementation of the main 
procedure. We make sure that the Tk package is available and 
then set the appData(os) array element to either “windows”, or 
“macintosh", oi “macosx", depending on whether die script Ls 
executing on Windows, Mac OS 8 or 9, or Mac 05 X. 

listing 7: Qi^iiiig the application _ _ 



it !iUrc the tesourccs wc need are available 
If [[catch Ipackage require Tkljl [ 
tk_messageBox -icon error -type ok \ 

message (Tk did not initialise.I 

exit 1 
I 

# we use a variable ^appDataCos)' that is more convenient for Mae OS X 
switeli - $: :tcl_platforin(platform) I 
Unix ( 

set appData(os) S: :tcl_platfQrai(platform3 
If [[package vcompare [itifp tclversion] 3.3] == 11 I 
if I [string equal [tk iifindowingsystem] “aqua"] 1 I 
set appData(os] "roacosx” 

I 

1 

I 

windows ‘ macintosh ( 

set appData (os) $;: tcI_platforin (platform) 

} 

1 

if I[string match “mac*" $appData(os)] ] f 
set appData(modKoy) CoiMnand 
1 else f 

set appData(modKey) Control 


it initialize global variables 
set appData(wlnNo) 0 
set appData(nextNewWlnNo) 0 
set appData(wioTag) winRTM 

* ercate a oew empty dircetory for temporary files 
if I[info exists :ienv(TMPDIR)] && \ 

[file Isdlrectory $::euv(THFDIR))I ( 
set appData(tempDlr) \ 

[file join :env(TMPDIR) $appData(wlnrag)[pid]] 
1 else I 


if I [string match “mac*" $appDataCos)11 I 
set trapDir /tup 
) else [ 

set tuipDir [pwd] 
f 

set appData(tempDir) \ 

[file join $tiiipDir $appData(wlnTag) [pid]] 

1 

if I [file exists $appData(teinpDlr)] J I 
file delete -force $appData(tempDirJ 

I 

file mkdir $appData(tempDii:) 

# set the currcni dircetory 

cd [file dirname [info script]] 

# set up Che menus 

if [ fstrillg match "mac*'* $appEata{ci3)]) [ 
setupMenus , 
adjustHenus 
setupBindings 

1 else [ 
newDoc 


# hide the mot wlnttow and die Console window 
wm withdraw . 
console hide 

1 

If we're running on Windows, we call the new Doc 
procedure to open a new empty movie window. (See Figure 
2 again.) Otherwise, we call the three procedures 
selupMenus, adjustMenus, and setupBindings, which well 
consider in depth in the next article. On both Mac and 
Windows, we hide the root window (whose name ts and 
the Console window. 

Movie Windows 

Earlier we saw how to use the toplevel coniinand to create 
a window. A movie window in TickLeez is just a toplevel 
window that contains a movie widget. Wc can create a movie 
widget by specifying a unique pathname to the movie command: 

raovie .$winN3m3.ti]0v 

And we can attach a movie file to that widget using the (X)nfigure 
command: 

.^winName.ffiov configure -file 3flleNaiiis 

In TickLeez, we want a movie window to be editable and 
resizable; we also want to be able to intercept movie controller 
actions targeted at the movie. So well call the configure 
command again, like tiiis: 

.$wiiiKame,mov configure -mccommand controllerProc \ 

-mcedit 1 -resizable 1 

In the next article, we'll see how to define die controllerProc 
procedure. 

Next we need to resize the window to exactly contain the 
movie and its associated movie controller liar. We can use the 


34 


Tickle Me 


MAdTECH • Volume 20, Issue 6 





pack command, which resizes a window lo exacUy contain the 
widgets inside it: 

pack .$winMa[tts.iQov 


Listing S shows the complete definition of the 
openFilelnWindow hinction. Given a full pathname for a movie 
file and a value that indioiLes whetlier the movie is a new movie, 
it opens that movie in a window on the screen. (Note that the 
-rasizable option does not appear to work correaly on 
Windows. This may be fixed in a future QuickTinieTcl release.) 

listing 8: Opening a movie in a new window 

opcnFilcin Window 

proc openFilelnWindov tfileName isNewl ! 
global appData 

# create a unique Tk path for the new window 

set winWaine ^appRatatwinTag) [inci: appDataCwinflQ) ] 

# create a new window 
topicvel H $winName 

wni resizable . SwinMame 0 0 

wra title .SwinName [file tail SfileHame] 

wia pietecol .SwinName WM.DELLETE^WTNDOW \ 

■‘at tempt Close $winNaine closing- 

if ([string match "mac*"* $appDatatDs) J J f 

: :tk::unsupported: :MacWindowStyie style *$winNajDe \ 
document IcloseBox horizontalZoom eoliapsefloxl 

i 

movie , SwinNaase. raov 
if ($isNewl [ 

.SwinNamc.iiiov new $fiieNanie 
1 else f 

.$winName.mov configure -file SfileName 


. $winName .mov configure raccomfnand controllerProc \ 
-mcedli 1 -resizable 1 

pack *$winName.iQov 

^ save wmdow'specihc inhj in global anay 

set appBata (SwlnName, tnovie) . $winNaBie. mov 

Get appDaca($wlnWaine.d!rty) 0 

set appDal:a($winNamc,fileNanie) $filel^arae 

set appData($vinNan)e,utidoLevel) 0 

force die new window to be displayed 
update idletasks 

setupMcnun .$vlnNaQie 
adjustMenus 

setupBlndings $wlnNamB 

1 


The OpenFilelnWindow procedure is called by two menu- 
handltiig procedures, newDoc and openDoc. The newDoc 
procedure, shown in listiog 9, creates a filename for a non- 
existeni file in our application's temporary directory. 
QuickTimeTcl requires tliar a file be associated with every local 
movie it manages, even for new empty movies. 


Ostiiig 9t Creating a new empty movie 

proc ncwDoc (I \ 
global appDats 


tiewEXx: 


# new windows are entitled “Until^ed.IrK>v^*‘Unatled2.a:ov^''Untided3.mov^... 
incr appData tne:xtKcwWitiNo) 
set vlsWinNuni $appData(oe)ttflcwWinNo) 
if [$vlsWinNum == 11 I 
set visWinNum *’*' 

I 


^ constniet a new temp file name 

set filename [file join $appData(teiiipDir) \ 

“Untitled^ fvlEWinNuiiil ,]iiOv“J 

openFilelnWindow Sfilename 1 

) 


The openDoc function, shown in listing 10, elicits a 
filename from the user by calling the tk_getOpenFi[e command, 
'fhis command displays the standard file-opening dialog box and 
rcLuras Lite full pathname of the selected file (or the empty string 
if no file was selected). 


T Jjsting 1 fl; Ratidlftig the Open tnemi item _ 

cjpenDoc 

pToc openl>oc I) [ 

Get fllenaine [tk^getOpenFile -title "TlckLeez: Open a \ 

Hovie File**! 

if E$filenaine !-•*"] ] 

openFilelnWindow Sfilename 0 

) 

I 


Conclusion 

In this article, weVe taken a preliminary look at TclA^k and 
the QuickTimeTcl add-on, whicli allows us to use the TclAk 
saiptiiig language to build a QuickTime’Sawy application, 
WeVe f^hioned our menus and menu bars, and weVe seen 
how to add a simple dialog box — our application's Al>oul box 
— to an application. Most important, we learned how to use 
QuickTimeTcl commands to open a movie file and display it in 
a movie on the screen. 

In the next article, well continue working with Tci/Tk as a 
delivery platform for QuickTime applications. Well see how to 
bind certain events to our application's procedures, and well see 
liow to handle standard movie editing. That of course will 
require that we also implement the standard document 
behaviors, such as prompting the user to save or discard 
unsaved changes to a movie tliat’s being closed. 
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The latest Tcl/Tk release for Windows ccjmputers is 
availaf>lc at the Tcl/Tk Developer Xchange site (http://VWW.tcLtk), 
You can download the QuickTimel'cl extension at 
http://hem.fyristorg.com/matben/qt. For Macintosh OS X computers, 
you should use tile all-inclasive Tcl/Tk distribution available at 
http://sourceforge.net/proiects/tdtkaqua/. 
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PROGRAMMING 


By Peter Amerl 

Running NAG F95 on a Mac 


Was Newton’s Apple a Macintosh? 


The Measurement Scales Uncovered 

W[{h OS X, Apple iinienshecl a new kx>1 upon the c'ompiiting 
coiniHLinity even Sir Lsaiic Newlon would liuve been proud to 
use. Who l<nows, niaylie he would kive l:>elonged to tliose in 
scientific computing who prefer to use the Unix cf)iuiuiind line 
intertace, and the X windows interface. Or, niaylie lie would have 
liked die slick Mac interface, and its newly ft)ynd flexibility. Either 
way, mast scientific programmeni whom I know (including myself) 
Lend to use the t:omniand line interface since their input and output 
data are weighed in hundreds of mega bytes, and the ccxle t)flen 
nruissages and stores the reduced data, thus Fecpiiiing only a very- 
liasic’ inlerfaix^. Furthermore, ccxling foi' those in science is a means 
to an end (fame and fortune). Often it is neeessiiry for sc ieniific code 
to lie portable, pennitting develojiment on the Mac while enabling 
conipilation on tlie latest I'emflop Cray, or sujxa' ckister. llus feids 
to my CTiLeria for the evaluaii[)n of the NAG t onipilen 

• A streaniJined coding ejivironment 

• a good syntax checker 

• an intuitive and easy to use debugger 

• compiler optimization ojitions 

• options to enforce siandard.s compliance 

l1ie bulk of scientific computing is performetl using twx) 
languages: C, and Foil ran. Although C has evolved over (he past 
decades willi many new scieniiric libraries, alistrjcLinn iayets in C++ 
simpiifying the coding process, it is not always the Ixst choice for 
sclent ilk’ cotnpnting. Many .solvrxl (omputational pi obletus are 
available on web sites sueli as http://vwvw.netiib.org. A gotxl inution 
of these roiuities aie coded using one of the Fortran llavois, 
Qaiseciuently, die langimge Is likely lo remain a scnentific favoilte for 
,stmie time. The seleciion of thiixl party Fortinn compilens avnliable 
for OS X is cjuite limited, and unfoitunately, a gcxxl open .souRe 
<x>mpiier for F‘90 or b'95 is not available to date. Current third patty 
contenders such as NAG P95, IBM XI, Fomnn, and Absoft FroFortran 
.support compilation of soujce ccxle lor the F77, F9f), and V95 
.standards. ’Ihis review will discuss the NAG compiler for Mac OS X. 


Experiences with the NAG Fortran 95 Comphj^r 
The Nag R)S tx)mpiler has a multitude of features, such as 
aittomatic file pteajiinection, IEEE 754 5up[)ort, automatic gaitege 
collection, memory rmdng, undefined variable detection, a random 
number geneniior (hat is seeded Imsed on the time of day, etc:.. Yet 
this IS all material that can Ik^ obtained from the tLsual proiraganda 
sheets. Once 1 had the NAG compiler installed and fenctioning, the 
fun started. The cxjmpiler ofXions are just what one would expect 
from a Un* *x .style Fortran aMiifiiler. The following ofxions sc! it apart 
from other compileis. It can jijrovkie compilation feedback that is 
color-coded, so tkii compiler w^ariiings, enon?, and mlbn-national 
massages are displayed iLsing diffemnl colors, Tliis makes it easier to 
sain the resulting output for compilation problems. Support for 
conformance checking Ls included, althoogli apparently only for the 
Fortnm 95 siancbrcl. Tills conformance checking t:an lx: perfonned 
in the following ways: the coinpilcr can pR)vide warning riicssages 
on the use of exteasioas to Ft>rtran, syntax Uiat was deleted in die 
transition to and olisolete syntax and commancls. One superb 
featuro Uiat NAG provides wjtli iLs Ftirtran compilers is rundnie 
garliage collection that am lx: eiiuliled with “-gc" during the link 
pha.se. In the pa.st, the automatic garbage ccillection has saved me 
valuable system msouro^s when a routine re|xtitivcly needed to 
allcxrate and dealloaite a number of laige clynatnic airays, 

‘ITie aMiipiler also accepts, and checks tlPF direaives, but 
unfortunately d(xs not compile them into the executable. Through 
die lack of AltiVec (a,k,a, Velixity Engine) libraiy support, it is clear 
dxu NA(3 created llie compiler to serve as a general-purpose, 
platform independeni tool, Mac G4 and G5 users must c:reate 
WTa]iper funttions in C++ to take advarilage of ihc AltiVec routines, 
a situation that is less than ideal for those looking for Velocity Engine 
peifonnance improvements. On the other hand, the lat:k of these 
additional funaions makes ihe NAG ctaiipiler a gcxxl (fcxjlproof) 
compiler to use for fx>rting ccxle to other platforms. An integiated 
ilevelopmenr environment is not provided with the aimpiler, further 
gearing die cxiinpiler to command-line or emac:s kx'ks (sudi as 
myself). At the tune of diis writing, the compiler was not designed 
to work with Xcode. Ihis omission may not lie a serious saimbllng 
bitxk as NAG dcxis supply iLs own graphical debugger, upsl95, 
derived from die t>jxn source npA ddiuggen Inl'oniiation alxxit it 


Peter Amerl is a FliD pliysicisi who ha.s been axJing sciL'niific daut reduction roudnes. and charged particle trajcciory siimilations for .scientific 
irLstmmenrs using Fortran 90 and 95 since I99h. Peter siaited Iris computing experience in 191^2 with the Apple 11+, eventually graduating to the Mac+. 
Fur a time of alxjut .seven years, he rurned to the dark side unlil 1994, wJien die ,sla[nlity of Unux cauglil Ills eye. This fairytale conliiuietl until a 
wondrous discovery ^ OS X. Now Peter liappily codes scientific rou linos on a G5. 
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oin lie found at http://ups.sourceforge.net. r foimd the debugger to 
work mncli like gnipliieal implenientations of gdl>g. For people 
witii duiil [mx-essor .systems, a more serious omissitjn is tlie lack of 
parallel prcxvssing support. 

1 suspect rlmt tlie NAG coiii[ii)er Is still showing Mime teething 
jxiias. [Jpofi installing the compiler on two s^^enis, a dual 05 running 
Fiintlier and a G3 running Jaguar, 1 im[mliately nin into trouble. On 
the 05, tlie conipilei' could nrt compile a **Helk} ^irld” program. Lising 
tlic '"ic'cc-fiJir <'onipilation Ibg clianged llie exccuUiblc favirably btit 
did mit entirely fix tlie pniblem. In all fairness, 1 later found lliat tlx* 
errf>r rxcTined evey^ time 1 uanpiled as the OEM user after allowing 
tlie ,sy,slem to go to sleep. On the G3 witli OS X 102.B, the ctxJe would 
not com|)ile under die OEM user. Magiciliy, the prd^kiiis dLsiifiixrared 
when I created a tion-adininistraiive user account to compile and 
cxeeult! programs. It is possible die problems were caused by other 
•sofhv'aie fiackagus iasiallal m Ixxh aimputers. Alter tlie initial 
fnLstration, the compiler ran smoodily. 1 axild even compile and 
exec^tle alxsut 13000 lines of scientific Fortran 90 txxle originitily 
destined for the SGI pjatfomi without prohleim. 


The BorroM Line 


Pros: 


'ITie compiler functioned well once its quirks were resolved. 
To me, the tkfbugger felt much like a graphical version of ‘"gdb" and 
was very usable. The compiler optimized the code noticealily well 
cojisidering its lack of AlliVa^ suppon. The color-coded compilation 
me.vs;iges are an excellent touch, and of greiit Ix^nefit to comni:ind 
line compilation. Most import:int to me, tlie garlxige colletiion, and 
cross-pladbnn corn pad hi lily fiinaioned superi:>ly. 

Cons: 

'Hie lack of an IDE or Xaxle compatii^ility forces die user to 
rely on other editors. ALso missing is die ability to compile ctxle for 
parallel prex'essing. It appears that on soiiie systems, the compiler 
can ixitentmlly act somewhat capriciously, Fortuiuitely, using a 
non-administrative account witii no adchtion;il software or haxies 
installed fixed code generation problenis for me. 

RE(X)MMENDATI0NS 

For anyone who has a favorite editor, and prefers to use make 
files, dlls compiler will be wortliwliile. If Xctxle integrate lo is desiretl, 
the NAG FJ5 com[>ilcT is not ihe tcxil to use. Petiiiips, with pix)[x.Tly 
placed suggestions from users, NAG will .support Xcode 
development in a future relaise. If you aie kxiking for cross platform 
coniptitibiiiw you will mo.sr likely also be w^eil served. Bel ore using 
the compiler I suggest die cTeuiing u cleiin user acaiunt. Once diis 
Is accomplished, run die amipiler tk^n widiin dial account. In any 
case, diis Is an excellent practic’e for computer security. 

Lm Closing 

Regardless of the compiler and operating systan, the Apple 
Macintosh would not have \ieen siiimble for Sir Isaac Newton. It would 
likely have rendered liim unconscioiis, or worse, as it fell on his liead. 
VC'Jio kn<)w,s, we might not know alxiut gratuity, or calailiLS, widiour 
Newton*s L'onirilxjtions. AlthcHigli most snidents wxxild lie much liappier 
wiriiout these, it would alst) make present eby oomputeis unlikely. 
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APPLESCRIPT 

ESSENTIALS 


Copyright 2004 £ 5 ? Benjamin S. Waldie 

Introduction to Scripting the Finder 


Lasi monih, we lcx)ked at the user interaction functionality 
in ihc Standard Additions scripting addition. This month, we are 
going to get started with some tiasic Finder scripting- We will 
briefly lcK)k at the Finder's dictionary, recording in the Finder^ 
and some basic folder maintenance- In tlic fuliire, we will 
explore other aspects of Finder scripting in greater detail. 

FiNOFR Basics 

Accessing the Finder Dictionary 

The first thing to note is that the Finder is noi the Mac OS. 
Tile Finder is simply an application in the Mac OS, and it 
provides you with a graphical interface for navigating and 
organizing your computer’s file and folder slaicrure. 

The Finder can be found in the System > Library > 
CoreServices folder on your computer. Please note that, 
much like any other application on your computer, the 
Finder's version number typically changes when newer 
system software becomes available. With these version 
changes, frequently comes new and/or modified 
AppleScript functionality, and updates to yt>Lir existing 
code may be required. 

Like many other applications on the Mac, the Finder is 
scriptable, and therefore contains an AppleScript dictionary. 
The Finder's AppleScript dictionary contains all of the 
AppleScript commands, objects, and properties that the 
Finder understands. 

To open the Finder's dictionary, launch the Script Editor^ 
loc'ated in Applications > AppleScript. Then, select Open 
Dictionary from the File menu. You may also open die Finder's 
dictionary from the Library palette in the Script Editor. If this 
palette is not visible, select Library from the Window menu in 
order to make it visible. 
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Figure L Ihe Firtder Dictionary 


As you look through the Finder’s diciioiiaiy, you will see that 
it is broken up into different sections, or suites. 'Ihese suites help 
to OJganize the dictionary into groups of relatetl objects, properties, 
and ctrminands, making the dictionary easier lo navigate. 

You may notice that certain things in the Finder's dictionary 
indicate a note of "NOT AVAILABLE YET". For example: 

Finder preferences preferences [r/o] — {NOT AVAILABLE YET) 


This indictilcs functionality that was present in Atoc OS9, but 
has not yet been fully implemented into Mac OSX. Ihis is due 
to fundamental differences in the way that the Finder liehaves in 
Mac OS X, versus Mac OS .9, 

Finder Recording 

You may be aware that, in addition to being 
AppleScriptable, some applicatiQn.s on the Mac are also 
AppleScript recordable. What this means is dtat you can click a 
Record burton in the Script Editor and then perft>rm the desired 
actions in the recordable application. Then, when you come 
back to the Script Editor, your code has been written for you. 
Tliis is a method frequently adopted by beginner AppleScripters, 


Benjamin Waldie is president of Automated Workflows, LLC, a firm specializing in AppleScript and workflow auiomation consulting, in addition to 
liis role as a consultant, Benjamin is an evangelist of AppleScript, and can frequently be seen presenting at Macintosh User Gn^ujis, Seybold Seminars, 
and MacWorld. For additional information about Benjamin, please visit http://www.automatedworkflowsxarTi, or email Benjamin at applesaiptguru@Tnac.com. 
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A,s you may have guessed, one such recordable application 
in Mac OS X Panther (103) is the finder. Please note that if you 
are using an older version of Mac OS X, this funaionality is not 
present. Wliile finder scriptal^ility is present in older versions 
of Mac OS X, the recording feature was not re-introduced until 
the release of Mac OS X Panther (10.3X The reason 1 say the 
word re-introduced"' is l>ccause the finder was recordable in 
Mac OS 9. Also, although the finder Ls recordable in Mac 05 X 
Panther iJ03)y you may notice that it will not record alisolutely 
every single task that you perform. 

Plea-se note that not all scriptable applications on the Mac 
are recordable. Only certain scriptable applications are 
recordable. Some popular recordable applications 
include -- BBEdit, MuitiAd Creator, QuickTime Player, 
Stuffil Deluxe, and Tex-fdit Plus. 

Figure 2 shows a baste script that was recorded in the 
Finder. This particular recorded script creates a folder on the 
desktop, and renames it to My Foidtfr. 


0 fl B Untttleii O 



Figure 2. A recorded Finder Script 


Writing Vs- Recording 

So, why record? Recording in the Finder, or any recordable 
application for that matter, can provide a quick and easy way to 
get started with scripting a particular application. If you are 
finding an application’s dictionary to be complex and difficult to 
navigate, or perhaps you just can't seem to get your syntax quite 
right, then recording can be a tremendous help. By recording a 
quick script, you will probably find the syntax tliat you are 
looking for, and all with only a few clicks of the mouse. 

While recording appears to lie a simple answer for those 
looking to learn AppleScript, it is not always the best option for 
the job. There are some disadvantages to recording. For one, a 
recorded script contains no logic. It simply contains a series of 
AppleScript statements to perform a set of tasks. Because of 
this, the script cannot evaluate situations or data in order to take 
different courses of action. A recorded script will anempt to 
perform the exact same tasks time and time again. 


Take, for example, the script 1 recorded a little earlier. If I 
ran the script as soon as I finished recording, I would liave 
received an error message. 

O O 0 _ymltled_C-J 


^ AppleScript Eirdr 

^ get trnr Ttvt operuiofl could |h 

Appl wF oMiipleted thtte it an K«rti wiA ih4i 

Ml ' _ 

i ^ > 


Sflt lume erf fcitiJQr of foldcir dt tdldftr 

of "^Usan" of siAriup disk tp "My FoUtor'' 
nnslie FlAder window to loldpf "My Folder" at folder "Oesktop" or 
folder "tMaldld'' of fofdor ’’Users" of staruip disk 

end lal 


DcKrtPtiOn KBwfc Event Ua 


Figure 3 An fxample o/a Recorded Script Error 

In this example, the script created a new ft)lder on my 
desktop and attempted to change its name to My folder. 
However, a folder named My Folder already existed on my 
desktop, thus causing the script to produce the error message. 

Ideally, a script of this nature would be written to anticipate 
such a scenario, and take a specific course of action based on 
whether or not a folder with the same name already existed. For 
example, the script could be written to check to see if a folder 
with the name My Folder exists, and only create the folder if it 
does not exist. 

set CheOutputFolder to path to desktop folder as Btrifi| 
tell application “Finder” 

set theFolderToCheck to theOutputFolder 4 “My Folder" 
if (folder theFolderToCheck exists) * false then 

make new folder at desktop with properties Inamer'My 
Folder"I 
end if 

open folder cheFolderToCheck 
end tell 

Another limitation of recorded scripts is that they contain no 
variables, handlers, if/then statements, or repeat loops. Because 
of tliis, recorded scripts are typically very verbose, and contain 
a lot of unnecessary and repetitive code. For example, lei's say 
that you want a script that will create ten folders, and name them 
from 1 to 10. To record this functionality, you would need to 
click record in Lhe Script Editor, and then actually create ten 
folders and rename them manually. Doing this for ten folders 
may not be too time consuming, but what if you needed to do 
it for a hundred folders, or a thousand? In order to do this, you 
would be much better off writing the script than recording it. 
With only a simple repeat loop and a few lines of code, you 
could write in a few moments what would take you quite a 
while to record. In addition, your code would be much shorter, 
more efficient, more expandable, etc. The following example of 
urifien code will create 100 folders in a user specified output 
folder, and rename tliem from 1 to 100. 
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set theOutputFolder to choose folder 

tell application '*Finder“ 
repeat ¥itb a from I to 100 

make new folder at theOutputFolder with properties 
(naneta as string} 
end repeat 
end tell 

The sample code displayed above does not contain any 
error protection or handling to check for existing folders with 
the same names, but this could [yc added into the script, tf 
necessary, with only a few extra lines of code. 

Witli recorded scripts, you can also go l>ack in, once 
recording is complete, and clean up and improve the code. ITiis 
is a .suggested pnx:cdua" if you do choose to record your scripts. 

Fo1J>ER MlRUnViG 

Creating a Folder 

As you have already seen from some of the code above, 
creating a folder in tlie Finder Is fairly straightforward. The 
following codc% which will create a new folder on the deskuip, 
illustrates this againr 

tell application “FlndGr*" 
make new folder at desktop 
end tell 

Once a folder has Ixren created, you will probably want to 
store a reference to a newly created folder in a varialile. This 
way, you can actually do something wilii the folder, such as 
assign a name to it, mt>ve it, opQn it, etc. 

tell application "Finder* 

set theFolder to make new folder at desktop 
set namE of theFolder to "My Folder” 
end tell 

Please note thai sinc:e the code alxjve will rename the 
folder, whose reference has l>een stored in a variable, the 
variable will no longer link to the folder once^ it has t^een 
renamed. Therefore, you will need to alias the folder reference 
once it has been cTeated, or re<Teate your variable to link lo the 
newly renamed folder. Por example: 

"iTiis code will alias the ftjlder reference, causing the 
reference to tlie folder to dynamically update, regardless if the 
folder is renamed or moved. 

tell application "Finder" 

fiet theFolder to (make new folder at desktop) as alias 
set name of theFolder to "My Folder* 
open theFolder 
end tell 

This axle will recreate the variable containing ihe folder 
reference, after the folder has been renamed: 

tell application "Finder* 

Bet theFolder to make new folder at desktop 

set name of theFolder to "My Folder* 

set theFolder to folder ((path to desktop folder as 


string) & "My Folder*) 
open theFolder 
end tell 

In some cases, you may want to specify certain properties 
of a folder, such as a name or a comment, during its creation, 
rallier tlian after it has been created. This can help to shorten 
your code and make it ttior: efficient. 

tell application "Finder" 

set theFolder to tnako rtew folder at desktop with 
properties (name:"My Folder", comment:"Test cononent"! 

open theFolder 
end tell 


Working with Folders 

Sometimes, when working with a folder, you may notice 
tliai the Finder's interface does not update immediately. This 
sometimes will occur wlien creating a new folder or file, or 
when moving, copying, or deleting a folder or file. To clause the 
Firicier to update immediately, simply use tlie update command, 
which will immediately refresh the view of the path specified, 

tell application "Finder" 

update (path to desktop folder) 
end tell 

When working with folders, you may want to customize the 
look and feel of an opened folden For example, you may want 
to change the view tjf the folder to list view, icon view, or 
column view. Or, you may want to change die size and/or 
position of the window to default settings. To do this, you need 
to actually work with the mndow of the folder, radier than the 
folder itself Tlie following sample code will create a folder, 
open it, set it to list view, and resize it to a predefined size. 

tell application "Finder" 

set theFolder to tiiake new folder at desktop with 
properties (nanie:"My Folder"! 
open theFolder 

set current view of window of theFolder to Icon view 
set bounds of window of theFolder to 113, 69, 470. 396J 
end tell 


In Closing 

This general intrrxluction should help you to get started 
with scripting the Finder. In die future, we will begin to take a 
more in-depth look at the different aspects of Finder scripting. 

In the meantime, be sure to check out die sample Finder 
scripts that are already built right into your system. You can find 
these sample scripts under Afpiicaiions > AppleScript > Example 
Scripts > Finder Scripts folder on your hard drive. These scripts 
will also appear in your Scriin Menu, if it lias teen enabled on 
your machine. These sample Finder scripts are unlocked, and 
fully editable for you to explore and enhance. You can also find 
additional sample Finder scripts on Apple's AppleScript web site 
at http;//wviw.applacorn/appl€saipt/toolbar/. 

Until next time, keep scripting! 
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REALBASIC BEST 
PRACTICES 


By Guyren G Howe 

An Interview with Geoff Perhnan 


Talking with the CEO of REAL Software 


Rtftxrnily, I sal down with Geoff Perljunn, the CEO of REAL 
Stjftwure, for a l^rief interview alioul REAUvasic. 

[Guyrenl Tell us a liule of yoiif personal and professional 
background, 

iGeoff] Alright, well let's start with cotaputers* 

rd come ht)nie from school, and I'd want to watch renms 
of MASH, Tlie reruns of MASH came after Star Trek, so I ended 
up liking Star Irek. Well, computers for me were ilie closest that 
I ctsuld get to Star Trek in real lile, so that's what got me 
interesk^d in coriiputers. 

Initially, my Dad brought home a Texas Instalments 
|X)ital>le terminal, and they liad BASIC on there, so we could 
program in BASIC. Then, I got into programming Applesoft 
BASICS And then, when the Mac t'ame along, I convinced rny 
barthcT who had a limousine basiness ilmi I would write him a 
program to track all liis tirders, Ii uxik me six months to write it. 
I could write it Uxlay in REALhasic prol>ably in a day, or Ies.s. 

After high scluxil, I went to work for AJ8cT lor a couple of 
years. Our office wa.s about 3f)0 peojile, and they would do the 
break schedules manually, which would take a manager one 
whole iky per week. Weil, f said to one of them, 1 can write a 
program to do this". So, I spent several weeks writing this 
program, and it giJt lo the where they could press a button, 
and out came the schedule. 

'Ilial letl lo all kinds of other opportunities. Liter, I went to 
work for myself, doing 41} consulting. [ did that until 199Ck went 
lo work for iD for 4 years, w'ent back to consulting with 4D for 
a while, and then in late '97, nime acrtxss CrojisBASlC 

I downloaded (Tn.ssBASlC, found ii really interesting, 
conta<n<.‘d Andrew I Barry], found out that he was not really 
working on it bill time. I asketl if he wanted to. He said yes. I 
put a business plan together, and off we go with Cros,sBASlC 
Ixx'oming RHAl.basic, and you know the rest of that. 


On tf) stxtne questions about business today. How are your 
licenses distributed, between Mae and Windows and both, 
people who get prtxfessionat standard...? 

[After the inlerv'iew, GcofT sent me 3 breakdown of recent 
sales, which he says are 80 percent commercial, 20 |iercent 
acatiemic; 74 percent stanikiid, 26 per cent profe.ssional; 77 
percent Macintosh, 23 percent Windows.] 

So how does REAL Software go about deciding wliat new 
features to have in a release? 

'lliafs a g<KKl cfuestion. Pan of ti is son of our long-term 
strategic vision fVir the prcKlua. 'lliat's a big part. 

Is that very detailed, or is it just sort of a broad concept? 

Wc stun will I something that’s very broad, and we know that 
there are pieces that need to be implemented to make tJiat vision 
happen. So, for example, witli our new database engine; 
uhimaiely, we'd like the KEAUiasic database engine to .stand up 
there with just alxjut any dantbase engine. But right now, it's 
fairly basic, no pun imended.... 

A database engine is a non-trivial thing to do; a little 
surprised you haven't tried to license somethitig instead 
for that 

We looked at licensing, and we even looked at acquiring 
a few engines, and that jii.sr never seemed to work out. So, 
ultimately, we decided, let's just write our owm engine. We try 
to create layers of technology so that we can give heaefils to 
the customer in pieces. For example, with tlie database 
engine, the first thing we did was we created the virtual 
volume. It was a deliverable that was a fVnmdation for the 
database engine. 

Just as KBScripl was iJie first step toward llie new compiler. 

Exactly right. RBScript was the first deliverable. 

Another big part of what drives the feature set is the 
feedback system. We go into the feedback system, we fiml 
all the feature requests, sort them by the number of people 
iluu have reported the feature request, and then we start 
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looking down iht! iind we basically start asking 

ourselves, bung for the ]>uck, whui are the best features? I 
mean, stippon for Palm is high up on that lisi, hui wcVe mil 
ready Un I hat, so there's no point in us bunging our heads 
against the wall trying to make that happen. That will 
happen down the road. 

Is there also any room ft>r engineers to add their own 
sort of creative concepts? 

Sure. The new IDK for version 6: that svoLildn’t have 
hap()cncd if 1 hatln'i pushed it, 'Hie way the new IDE happened 
was that there were just a lot of variables ihai t^ame together that 
made me realize that we were at a jxiint now where ii/s fish or 
cut bail. 

We'd planned two large features for 5.5. If we did them, that 
was an even l>tgger investment in the current IDE. We knew^ we 
wanted to port the IDE to Linux, I'lial was going to Ix.^ antillicr 
big investincni in ilte I DR, so I knew that if we didn't port the 
IDE to lUiALhasic now, it probai>ly was going to Ixt'ome 
proltil>iiively expensive to ever do it in the future. 

Would you care to say what those two features were? 

Yes, rine is version cantrot, and the other is visual (irinling, 
laying out something that yon want to print visimlly rather than 
having to do it all in cxxlc. 

.So wliiit has been the most interesting thing that lias 
happened in the last six years? 

When Andrew departed, it was an interesting cx[x.Tien(:e to 
rebuild the engineering fe;im. It also became clear to me as I 
started down that road that we had to grow up as a company. 
We didn't have enough foniud processes in place, no we Ix^aime 
a more mature company as a result. 

Dial was really interesting, becaiLse it felt like such an 
unknown to me. I low quickly would we build a new team? Mow 
well were they going to work togellier? Were we going to go 
through a lot of turnover in that prexess? 

What about difficulties? That sounds like that was a pretty 
major difficulty* 

Probably the tiling that was the most difficult is that it's 
surprisingly difficult to create a culture in a company. 

f was going to ask you about tliat. You’ve done a very 
got>d job (witli the] user eonimunity. Did you set out with 
a deliberate vision of culture within the community and 
the company? 

It was all the things I wished a soft ware company did when 
1 wasn'i running a software company. 

And that's preiiy muc:h worked out the way 1 w'anted it to. 
I think part of that too is that it's ciisy to say well, that doesn’t 
scale, as you grow you're not going to be able to lx* as 
communicative, you're not gtiing to be able to answer email 


quc.stk>n.s from individual cusfomeis, Welf if you lielieve that, 
then that's right. 

Tell us more about the culture of tlie eonimunity and the 
company* 

As we've grown. I’ve felt that it's iniptiriant for us to 
coniimte to he really close to our users, A lot of companies 
have that closeness when they're very, very young. And as 
their pnxJuet and tlieir company jiiaLures, they kind of hack 
off from that, lielieving that tfiey can't do that any more. 1 
don't believe tliat. 

Any customer, for example, who ordtrrs our prtKhicl and 
Ixahers to write something in the comment field, will get a 
resjH>nse from me, perstmally. People are shocked. I'hey can't 
Ixlieve that anyone read the comment, they figuretl it just goes 
into a bucket somew^here, Diey can't Ixlievc liiey got a 
response to the comment. They ain't Ixlieve they got a 
comment so fast, and they c:an'i bt'lieve it's coming from tlie 
CKO. fhey're just amazed. 

Scott Crxik, who's the chairman of the board for Intuit, was 
once CEO, Fresidenl, founder and all that; I don’t know if he still 
does this, hut I know that wlien he wits CEO, he would .spend 
a Few hours every week doing tech su[>[X)n lor Quicken, 
Ixcausc he wanted to stay in touch with ai.stomers. I think that 
Wits really smart. 

In terms of our culture inside the company, I really like 
consensus, so if I suggest something and the consensus is 
no, this isn't a good idea, unless t feel very, very .strongly 
about it. Pm going to let it lie. Now, if I feel very strongly 
about it, then Pm going to try to coniinoe to hammer on it 
to achieve consensus. 

Is there anythmg you’d riofuiiiate as being tlie most 
satisfying? 

Diere are two things that have Ixen tlie inmi satisfying. The 
first is, it's really, really satisfying to provide jxtiple wiili 
something dial's so enabling for them. That allows them to do 
something that they fell lliey could never do Ixfore. We get 
('ommenis on a daily basis, from people sayiiig I could never 
have done this. I have a whole new career, Pm so proud of 
myadf for' doing this or liiai. 

Die second thing is that in the past, Pve eitlter worked for 
myself as an independent consultant, or I’ve worked for a 
ccimpany. And I saw how the company opcrattxl, and 1 had my 
ideas about how it .should lx changed to operate Ixtter And a 
lot of that wa.s just my thoughts, 1 had no idea if those things 
would retilly work. And in that a^spect, ERA I. Soft ware has been 
an experiment in my own vision for how a software company 
should run. 

Is there anything you wisli you’d done differently? 

Well, r>kay, so here is how 1 feel about that whole idea 
of looking !>ack, alxnit I wish T'<1 done this or that: life 
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doesn't work that way. Every decision you make leads lo a 
new set oi variables^ leads to a new scenarkc Your life takes 
a different path. 

For ute, 1 see an ad in MaeWeek magazine, a tiny little ad 
for 4D, saying they were kxiking for tech support people. 

So 1 st!ni them my resume. And tltut led to Silicon Valley, 
whieli led to my life in the computer industry. Chances are, had 
I made a dilTereni decision at that moment^ i wouldn't l)e doing 
what I'ln doing tf>day. I wouldn't have tnoved to Texas, I 
wouldn’t liave met my wife. So, would 1 have done anything 
different? My attitude toward this is that if you like die way 
things are now, then you can't kxik back in hindsight and say 
you wish you did anything different. 

So I ktiow that’s kind of a philosophical answer, hut it's the 
way I really feel ahtnit all kinds <jf things. 

Now the compiler is done..,. 

Wail wiiit wait. Ihe compiler is never 'done'. 

Now that you've inipleniented the same features yc»u had 
in the old compiler.,, 

We’ve swtklied the tompiler, yes. 

...can we expect any interesting new language features, 
perhaps smnething novel like Events? 

One of our reasons for implementing the new compiler 
was we needed a belter way lo extend the language. The old 
compiler was a hand-written parser, and that led to lots of 
ambiguities in ifie language. The new compiler is wrirren 
u.sing Bison, which creates a very consisteni language, and 
that was our first goal, to gel thai otn and jusi gel parity of 
the language. Now dial we've done that, ihere are all kinds 
of tilings dial we think about adding. And, weVe already 
done some of them ^— if you look al the release notes for 5.0 
and 5.5, ihere are new- language features in there. 

Nothing really major, though. 

Ihere are bigger fish to fry al diis [loini. We have 
opliiuizations we want to put in, supiiort fordiffereni back encls, 
native linkeis for Linux and Windows, dial kind ofsiuff. Sc? right 
now, you're seeing kind of .smaller language features that are 
going into die product, only liecause there are more important 
diings lhat we’ve just deckled musi come first 

For example, ilie way we handle resources on Windows is 
limited by how we do our litiking on Windows. We need a 
naiivc linker for Windows, rather than the sort of IxKit-strap 
linker we have nc?w, in order to solve the resourt:e problem. So 
you'll see more, liigger language features in the ruture than 
you're seeing now. 

Pd like to go hack to something that Fd like you lo expand 
on very briefly: just what Ls your long term vision? 

The long-term vision for REALbasic is tor people to Ixf able 
to use one language, one IDE, one framework, and lx; al>le to 


create any kind of software they want and deliver that on any 
platform they need. 

Kighi now, we deliver oti Mac, Window's and Linux, but 
there are other platforms, PalmOS, Pocket PC, Symbian OS for 
cell phones. Right now, we deliver just iiesktop applications, 
and now tx)nsole applications itt 5.5. But there are other fornuits 
iliaL stjfiware conies in. At the IRliAL Workll <'onference, we 
showed off a new protlun code-named SwoRifisli, for building 
web applications. We warn our users to i>e able to huik! PDA, or 
handheld device applications. We want them to be able to build 
j>lug-ins for other products. 

And this is hir three reasons. One is that it makes sen.se 
for there to be a single environment, language and 
framework, that you can use for writing whatever kind of 
software you warn, tmi we've come far enough with 
computers, and software that you should lie able to use a 
lugherdevel language to do that. 

Also, people invest a lot of lime learning a language, and 
learning a framework, and learning an environment, so the 
more things they can do with that, the more confident they 
are gtnng to he that they've made ilie riglii choice in learning 
that environment, wiilch is only going to help the user 
community grow. 

Listly, all those ways to deliver software that wc give our 
customers are poieniial entry points for people that aren't 
using our product now. For example, if you have no interest 
in building desktop applications, we can't get you as a 
customer today. But, wht'n we ship Swordfish, if you’re 
inierested in huikling web applicatk>n,s, dun may l>e how we 
gel you as a customer. Or maybe you look at REALbasic and 
you say, if 1 learn this, not only can I Iniild w'eb applications, 
but I can also build desktop apfilications. So you may have 
come to us with only one very' narrowly defined need, hut 
tlien your confidence in clKKising us grows liecause you 
realize ihai that investment of your time and energy i.s 
applicalile to lots of other ureas. 

So that's kind of what the visitm is for ilie prtxluct. 

Do you get a lot of people coming from VB? 

OK yes. Recently, Gartner Group did a i>oll of like a 
ihoasaiid VB usens, and fountl iliai 15% tk’ them were kx)king 
for an alternative to VB.neL They're looking at Java, they re 
looking al other things, ilopelully, if we can get llie w'ord out 
more in the Windows community, ihey'll be k)oking at us. 

While we're oo the subject of Microsoft, I ju.st wondered 
about the Office API, As 1 understand it^ some of the add¬ 
ons you get when ytiu get Microsoft Office are actually 
written in REAUjasic, is Uiat right? 

Yes, they do a lot of prototyping at MitTosoft using 
REALbasic. And Microsoft Query for Mac 05 X i.s written in 
REAlhasic, The Welcome App lhat tells you alxnit the features 
and die software license and so on, that's written in RF^Lbasic. 
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They would amially like to be able to write Office pkig-in.s in 
REALbasic, luiL wc don’t support tliat yet. 

Iliat’s really surprising; it doesn't sound at ail like 
Microsoft. Who came to whom? 

That all started wlien we shipped Version 1 at Macwtirld in 
New^ York, [Ltly 1998. We were sifting there in oiir little ten by 
ten booths pitching REALbasic. And these two gnys from 
Mitio.stTt on tile very first day of tlie sliow\ come walking ifilo 
our booth, anti I’m just thinking the worst. 

They intr(xitK:e themselves and they say that they're witli the 
Mac business Unit at Microsoft, and we'd like to talk to you guys 
alTout woi king togetlier to make your product talk to our product. 

So they came to you. 

They came to us, at the trade show. AjkI 1 was totally 
shocked, I thought this is the la.sT thing they were interested in. 
And taler, as tiiey were poning Office to Mac OS X, we talked 
alxjut adding Office support, but it was a big job, ajid we aiways 
had bigger fish to try. So when they started doing the port for 
Mac OS X, I hey weren t totally conficleni lhai tiiey were going to 
jx>rt the VBA code to Mac OS X. Their tliinking was that may lx? 
we can get the guys from HEAL Software to prtivide tliis 
functionality, and then if the p<m of that VBA code doe.sn’t go 
very well, we can shil't over to using REALbasic. 

As it turned out, that port actually went fairly smtKirhly. So 
they went ahead and ported the VBA stuff, hut iliey really did 
not want to promote the ’VBA stuff. Wc existed, they wanted us 
to provide a solution, and they wanted to [Xjint people to us. 
They figured we were going to do a better job in tliat space than 
they were going to be able to do. And because weVc going 
tlirough tiieir library directly, the APIs are 99% the same. You 
coukl go I'iuy a lx)ok at Amamn on VB or VBA, and chances are 
just about all that code is going to work in REALbasic just as it 
is in the book, and lx? cross-jdatform. 

YouVe mcnltoned hand-helds and plug-ins. Are you 
prepared to say aiiydiing about die lime frame for any of 
that stuff? 

Nul really. IPs likely to be the next thing that we take on 
after Sw'ordfislr I mean, we certainly want to do it sooner railier 
than later We don’t geneiully talk in much detail dboul what 
we're going ttj do in the future, liecause we prefer to nncler- 
proinise and over-deliver 

What about community features? As 1 say, 1 think you've 
done a great job so far of building comniunity around 
REALbasic, but there are some tilings that it seems to me 
could he imprtiv€?d. For example, although 1 think KB 
Ciarage docs a pretty gotHl job, it may l>c belter if 
something like tliat had the imprimatur of the company. 
Are there any other sort of community features youVe 
working on? 

WeVe talked about a code libraiy in the past. Our general 


feeling is that we prefer places like HB Garage to do that. I think 
that places like RB Garage, if they stay on track, they could 
become that. 

Oil the other hand, weVc talked about building a feature 
righl into the IDE thal would access a server here at REA!. 
Software, where ]Xople could contribute ctxle, and we could 
indiaiie diat we reviewetl it, and they axild type in a few 
keywords, and have it find some function that theyVe needed. 
WeVc also talked about building a chat application into llie IDE, 
so tliat if you wanted to ask a riuestion, you could go to this chat 
application and it would s;iy tha! tlie re w^ere 40 REAl .basic experts 
online, and you could type in a tjucstion, so that people in our 
community' tliat w^ant to help each other don’t have just the list in 
order to do it. They would have a tiiore instant intemetion. 

Welt, tliatiks for the interview. Is there anything that 
you’d like to say to the readers of MacTech? 

I guess what 1 would say is that if you liave any impressions 
of what you tliink REALbasic is, and you haven’t really given it 
a thorough run through, you really should look at it. A lot of 
ptx)pie who are C and C++ prognimmei-s hear the word BASIC 
and they think it's a toy language, that it's inteqireted, and so on. 
Well, it's not a toy language, it's as object-oriented and as 
powerful a language as java. It's machine ctxle compiled, and 
you'll l>e able to do practically anytliing you were doing in C++ 
a lot faster in REALbasic, and on more platforiiLs. But you have 
to be willing to look at a new language, and get past the name 
BASIC, and leave lx?hind all of your prejLidice.s or preconceived 
notions alxiui what you think BASIC is, and what you think 
REALbasic is, because chances are, it's not anything like what 
you expect. 

The engineers here at REAL Software are all C++ guys. But 
in general, they all prefer to code in l^ALhasic now, because 
they am simply work faster than Uiey can in C++. And theyVe 
all extremely talejiied C++ programmers, st> it's not thal they're 
lacking in that respect. 

Thanks. 

Yoifre welcome. 
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By Mark Choale 


CGI Programming with REALbasic 
and Apache 


Wilh the recenL release of REALtiasic 5.5, Rli become an 
excellent tcx?l to use for web development. The most recent 
version sports improved nerworkinj^ features and support for 
XMT- (including XSLT and X(|ueryh plus the ability Lo compile 
command-line ap]ilications, called cofwok appUcaHom in 
KHALba.sic. Perhaps most mtere.sting is the ability to compile 
applications for u.se on Windows and Linux, in addition Lo 
Macintosh platfonns. 

'I'raditionally* Mac web servers cxunmunicated with CGI 
applications through Apple events. This doesn't work with 
A[>achc, however, so a CGI application needs lo lie able to 
be able to receive information bom the server in the normal 
CGI way - through environmenl variables. This article 
illusiraies the steps necessary to iiiif>lement this in RKALbasic. 
One important thing to note: since many of the features that 
enable CGI programming in REALbasic are new, the current 
release (5.5.1) iias some bugs, whit li 1 have liad to work 
around. Some may lie fixed by tlie time this article is 
released, but hopefully this will save you some time for those 
that have not been fixed. 

Tlie first step will he lo review CGI progranulling for 
those who aren’t familiar with it. CGI stands for the corntnon 
gatetmy inlerface. ILs called an interface because it providesS 
the means for Apache (or any web server that supports CGI) 
to execute .scripts and applications on the host machine of a 
web server. When a ttser types a URL into his or her web 
browser, that URL often represents the location of an HTML 
file that the server just picks up and sends back to the 
browser In a CGI progranu the URL represents a script nr a 
program lhat gels executed. The oulpul of the program then 
gets sent hack to the user. In order to provide security, 
Apache allows the administrator to configure which 
directories allow CGI programs to be executecL On 05 X the 
c:gi-l)in directory is lierc: 

/Library/WebServer/CGI-Executables 


This article assumes lhat you Ixiven’i made any chimges to the 
default Apache configumiion that comes with OS X. 1'be 
configuration file that Apache ii.ses is available at /etc/ 
httpd/http.coni'. If you have never mixlified this hie, now is not a 
goexi time to stait - but you shouldn’t need to. ILs worth taking a 
lfx)k at it ju.st to make sure that CGI is set up properly. My 
liLLpd.eonf file has this, abt)ul 2/5 rif die way tluougii tlie dtxrument: 

# St:ri|>iAILis: lliw cotiimisp whidi direciorits aaituid strvtr siuripis. 

* Script Aliases :ire essentially ttie same as Aliases, except thai 

* dcHziimeriLs in the rvulname direetcir) ane treated as applicatkms and 

* niii by the stm't when requested rather than a.s documents sent to the client. 

#Tlie same rules about trailing 7” apply to Script Alias directives as to 

# Alias. 

# 

ScriprAlios /cgi-bin/ “Vlibrary/WebServer/CGI-Executables/*’ 

The last line indicates two things. Vegi-hin/’" is going to he 
part of the URL for the CGI application - something like: 
http://[ocalhost/cgi-bin/ plus the name of your script. The .sectjnd 
path is tile absolute path for this directoiy on the seiYer. For this 
exatnple, well be placing our REALbasic CGI program in this 
diieclory, Sometimes you1l see CGI scripls that end w'illi a ^^ egi” 
extension, but we won’t need to use that - in fact, you should 
avoid using any extensions because it will mess things up. Other 
.scripting languages, like perl and Pytfion, usually reside on die 
web server as text files that are executed t)y an interpreter. 
Apache uses extensions to map an interpreter to a particular Me. 
Since RKALbasic is a compiled program, it doesn’t need an 
inlerpreter and it’s better just lo leave the extension off. It also 
[provides for a much nicer URL, which is impoitanC, too. 

Now we can start work on the program. 7 he easiest way to 
work is to save the project in the CGl-Executables dimciory. Tins 
is iTecause you 11 need to compile the application in order to test 
it with Apache, and it’s easier to just compile it and leave it there 
to test than it would !>e to compile il and copy it to the CGI 
dirccRjry. 

In RB, a console application i.s one that does not have a 
graphical interface - it runs on the command line. In order to 
create a console application, simply create a new project in 
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KhALbasic ‘>.5+, and select the “Console Application” femplate. 
Once dial i^s done, RB will prtwidc you widi die sliell of an 
application widi one class calleil "App”. 



figure L Starting a new comoie alplicaHon in RfMhasic. 

There are twcj default events in a console application - 
‘^llnhandledKxception” ami "Run", 'llie "Run” event is tri^^ered 
when the program is laundied - in die case of a CGI applkadon, 
it is triggered whett a user requests it by typing the application's 
LIRL in her web browser. 



Figure 2. Blank console application project. 
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Now is a gtxxl lime to select the FII.B ® Build Settings... 
menu and coniigure the application. Select “Build for OS X” (this 
program has only been tested on OS X, although it should work 
on other platforms as well. Click on the top popup menu on 
the page, and select “Mac OS Settings”. The only thing to cliange 
here is the name - Ixr sore to give it a name without an 
extension and without spaces or punctitarton. In this example, 
fve chosen ilic name "CGI”, which Is sliort and easy to tyjjc into 
a browser window. 

Once tliat is done, it's lime to write some code. 

Since console applications do not liave a graphical 
interface, they have to be able to input data and output data 
in stune other ta.shion. For programs that are executed on the 
command line, this is typically referred to as “Standard Input” 
and "Standard Output” respectively. With a RTALbasic 
coasole application, the command "INPUT” represents (you 
guessed it) .standard input. “PPriVT” sends data to .standard 
output In addition to standard input and output, CGI 
applications also make use of environment variables that are 
set by the web server. Tn order to access environment 
variables, you need the .system object, which includes the 
method: System.EnvironmentVariahleO, which returns the 
value for the environment variable that is passed to it. In the 
current version (3.5.1) there is a bug lltat causes REALbasic 
to crash if you try to access a variable that does not exist, 
'f'his places some real limitations on what you can do, but it 
is supposed to be fixed in 5.3.2. 

The console apj>lication “App” class is where the action is. 
It has two events: “Run”, and “IJnhandledFxception”. The “Run” 
event is triggered when the application is invoked by the web 
server, so it is in the “Run” event that we put the main pait of 
our code. I also created a “request” ol^ject, which is created 
when the “Run'' methtKl is execureti. It is a sub class of 
Dictionary and it Ls used to hold the data that is passed to the 
CGI application from Af>ache. It also executes a “Write” method, 
that sends data back to the client i:)r<>wser. 

The "Run” method shoukl Icx^k like tliis: 

Ajiji.Kuii 

/if p ra gma d i sa b 1 eEackg r otj ndTa sks 

request = new request 

request,value("SERVER_S0FTWARE”) = 

system. en vi ronmentVar la bie I SERVER_SOFTWARE") 

request.value (“SERVER RAM") - 

nysr.fira, nnv I ronmentVa r i ab 1 e “ SERVER_MME'‘) 

request.value(“KEQllEST_HE'mOD'’) - 

system. eiivlcpimientVarluble f ■'KEQUEST_MJiTllOD“) 

request, value (“qUERY_ETRING") = 

system. envirotuneiit Variable (“ QUERV^STRING”) 

request, va I ue (“ RRM0TE_AD DR '*) * 

sys Lem. cfivl roamert L Va rlab le (■’EKM0TR_ADDR **) 

request.getQueryString 
request,handleRequest 


CGI Pl^CJGKAMMl^G wriH REAJ.BASlC ANO ARACHK 
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BiK’kgroLind t;isks are disabled because Apache doesn't 
work well with them. If you don't disable them, eveiy tinie you 
do a loop, or execute anything that loggers a new lliread or 
background task, the application crashes mercilessly. 

In this example, 1 have only gathered the minimal 
environment variables necessary to execute the program, 
because of die bug mentioned earlier. One notal^le environment 
variable missing is "Hl‘rP_COOKlE", which is very' useful if you 
use cookies, wliicli provide a way lo track a visitor to the site. A 
coinfilete list of variables Ls included in die sample script, liut 
commented out. 

The two variables that matter mosi to use are 
'^REQUBST_MET?101)” and "QUERY_STR[NC/. Tiiere are several 
kinds of requests a web server can accept. Hie two that concern 
us are hYxst" requests and "Get” requests, 'llie distinction 
between the two in actual praetic’e is virlually non-existent, 
except iliat it changes the way tliat fonn data is passed to the 
CGI program. 

Any lime you fill oiU a form on a web page, either to log in 
or make a purchase, the information lliai you enter needs lo be 
transferred to the servei’ so that it can take some appropriate 
action. When you create a form in H'lML, you liave the option 
of scleciing ilie reque.si ineiluKi you want to use - cither “GeC 
or ‘*PosC, If you choose "CieC, then the data fiDm the fonn is 
encoded and sent across as pan of the LIRL. If you use “FosC, 
then the data is sent lo the CGI [irogram as .standard input. Here 
is an example of a ""Get” ret|uest URL: 

httpt//localhost/csi-bin/teSt?cac=do& 

Tile first step in processing a CGI request is to find out what 
kind of request It is, anti process it acc'ordingly. In the re<]iie.si 
class, I have ini[>lenieriled die following luelliodi 

App. rcqutrst.gclQucry SLrinj; 

f pragma disableBack^roundTasks //Throws an error durinj; the Itnip 

Dim qdery string, field, key* value Ah String 
Dim X Ar Integer 

query * New Dictionary 

//If rhe REQUrsiLMEJliOD Ls n q>nsr, ihcti go thf siring fmnr sDnidiird input, 
otlH-Twisc get il iVuni qilliRV_SlRlNU 

If me.hasKeyC"REQDEST_KBTHOD'*) then 

if Die.value(‘'REQIJEST_ME™ d-J - “POST" Then 
query string = Input 
Else 

quory_sicing ^ 

S y s i em. En V i r 0 umo ri t Va r i a b 1 c (** QUEK Y_S T KING") 

End If 

end if 

if quccy_string <> then 
//parse the query siring 

For X = I to CounrFiolds [query_strins. '*&**) 
fU‘ld = NihFioldtquory_string. x) 

key “ WthField(field. , 1] 
value = NthField(field. 2 ) 

value RepiaceAil(value. . " “) 

value = Decod-eURLComponentt value) 
query*value(key) ^ value 
Next 
end if 


The method creates a new^ dictionary to hold the values 
of the query (the data from the form), If the request method 
is a 'Hosi", then ihc mciljod grabs ihc .siring from standard 
input. If it is a "Get”, then it grabs it from the environment 
variable "QUERY_S'rRiNG”, Beyond that^ everything else is 
lire same and the string is parsed and I tie dictionary values 
are set. 

We now have a request object that contains all the needed 
values from the request, plus the tiuery parsed into a diciionaiyc 
Nonnally, tliis would be sent to some metiiod dial would 
provide a response based upon tlie content of the queiy , For our 
example, we ll just send back to the client all the information 
sUired in the rec|uesL object. 

To send data back to the client, we need to send siime 
header infonn^ition followed by an H'l'ML string. 

App.rajucst .write 

tif p I a gma di a ab 1 eBa c k gi outidTa s ka 
// simple wriii- mciliod ih:n n rurm rhe in ilif aques:. 
dlra output as string 
dim html as string 

dim requestString, queryStcing as siring 
dim x,y as integer 

// sot rhv rjhic for'Conti'iiHypc". follnwcti by a bl^itik line 
output = ""Content-typo; text/html" chriH) + chr(lO) + 
chr(l3) + chr(lO) 

// crtuif the 111 ml sirini' 

html “ "<htMl><head)<title)TastOutput(/title)Ghead)(body)'" 

y ntu. coil fit 
foe X = 0 to y-L 

raquestStrilig = requeatString me.key(x) + “ + 

me. value (me. key (x)) + "*<br />"* 
next 

y = me.query.oount 
for X = 0 to y I 

[|ijf?rySl ring = qyorySrrlng + pii?.query.key(x) + ”:« + 
me.quety. value (me. query .key (x)} + "‘Cbr 
next 

htffll = btml f requeststring + quaryStrlng + 

"</body></htmI>" 

output = ovttput 4 html 

print output 

If you placed I he application in the 

/Library/WebServer/CGl-Executables directory, and set the 
applicalion name as "COP, then yon should be able lo access 
the script iVoni the following URL: 

UKalhosl/cgi-bin/CGI/CGI 

You should be able to paste it in tfie browser, hit return^ and 
then get back a list of the varialiles. If you want to test the query' 
string, then enter a URL like llie following: 

Local host / Ggi ‘ bin/CGI/CGI?key-‘value 
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Fi^^ure 3- Rcsuiis nJCG! appHcaiiou. 


You now have a ^ood starting poinr for wriring CGI 
progmois ill RUALhasic for Apache. One thing you’11 ntUicc, 
especially if you have a lot of traffic on your site, is that CGI 
can he slow at times. The reason for this is that the program 
has to he started up with each request, which produces u lot 
of overheatl. I’he downside to KB is tfiai it produces large 
executable files - alxml 1.3 MB for this simple CGI program, 
so tile particular solution is best limited to low-traffic sites. 
Because of this, there have been a variety of CGI 
workarounds that speed up tlie [process. They way they work 
is that instead of invoking the program each rime It is 
requested, the program stays resitleni in menitiry and 
handles the requesis a.s they come in. This is usually 
accomplished with an Apache plug-in. This is an interesting 
approach that can he used with REALhasic as well - and you 
don't need to rely on console programming. 

1 developed an RB application that worked with an 
Apache plugdn called “mod_scgi". Mod_scgi works hy taking 
the data that Apache W'ould normally send as environment 
varialiles to a CGI ]>rt)gram, and instead sends it as a block 
of data over a TCP connection. Using RRAl.basic's 
networking abilities, you can create a ScK:kelServer that 
creates a pool of TCPSockeis that listen on the appropriate 
port, gets the data wiien it is available, parses it and acts on 
it ju'it like a CGI program. As soon as the individual socket 
is done, instead of exiting, il returns to listening on the port 
for the next request. This creates a huge peiforniance horjsi, 
and is a tactic that should be considered if you expect a lot 
of traffic to your site. 

The original (and liest) guide to CGI from the inventor's of 
Mosaic, NCSA: 

http://hoohoo.ncsa.uiuc.edu/cgt/ 
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RAE INTERNET'S 
MPP 


By Lon Baker 

A platform for protecting mail servers. 


Now / can sleep at night. 


Tui- JOY OF INFECIED AND UNWANTED E-MAO, 

(^n May i, 1978, tlie first spam messai^c was njcelvcd. In 
1981 ihc Apple Vimses 1, 2, and 3 seen “in rhe wild' on the 
Apple IT operalin^ system, spread thrtiiigh pirated computer 
games, and Texas A&M ITniversity. Tlie first threat of email 
delivering a virus arrived in the form of the ''GtxxJ Times’" email 
hoax in 1994 with the ‘^Melissa" virus, W97M/Mclissa, delivering 
on the threat in 1999, executing a macro whicli forwarded itself 
to ^0 people from a users address lx>ok. The genie was out of 
the lK>tile, and managing e-mail senders has never lieen the same. 

With the growing sophistication of attacks tothiy l>eing the 
.single lai^est headache for anyone rtinning a mail ser\^er 
endures. The growing drain on time, and resources to battle this 
scourge has ibrced every administrator to develop an arsenal of 
ioob and techniques. But how does an adniinislralor manage tlu‘ 
array of anti-vinis and anti-spam scanners? 

BlULDLNG a E-MAIL EILTERLNG SOHmON 
Here at St^eedymnc, our ejients, including technical supixm 
scaiccs, rc“al estate appmisers, and busines.s owners of all types, 
demand defKmdable e-mail with minimal impact from spam and 
viruses in order to condua their business. Over time, wc 
expkired numerous scanning S(>lu[ion to meet our clients needs. 
Each solution culled for a significant level of work to integrate 
with our mail server. We encoumered daily challenges in 
managing vims definition tiptlates, installing new filters, and 
numerous other administrative tasks. 

dlie most lime consuming asj>ecl of dej>Ioying these st>luttons 
has always been determining the most dependable and efilcient 
methtxl for integrating c-ach .sc:anner with the mail server in some 
oises a simple perl script was ail that was rerjuiied, while others 
{■alleti for homegrown txxle pieced together in spite of conqxinies 
refusing to officially supp<m Mac OS X. 

We found this prtxess UK)k far U)o much development lime 
in light of the evolving sophistication, and volume of the 
message [layloads targeting our diems. We wanted to spend 
more time improving accurac 7 , and de]xndabilily of our service 
and less titne gluing the pieces together. 


RAE Internet has developed a product that fit the bill for 
wliat we needed. MPl^ (Message Prexessing Platfann), a Unix 
daemon deployed on a mail server, or as a SM'PP proxy iliai 
provides a platform for integrating a wide range of scanning 
solutions. Built around the concept of consoliditing 
configuration and management tasks, MPP\s arcliitecture 
supports a wide range of mail servers witli scanning tasks 
handled via dynamic scanning modules. 

The mail servers su]:»poried by MPP include Communigaie 
Pro, Postfix, Sendmail SeigeMail, and Qmail, and the dynamic 
scanning modules currently available for Mac OS X include 
Sophos Ami-Virus, CybersoiVs Pattern Authority, ClamAV open 
source anti-virus scanner, and the ubiquitous ,SpamAs,sassin, 

A key point for us was that MPP offered a consistent, and 
stable jdaifonii to impleincni a wide army of scanning sokitions 
on Mac OS X. We were able to t|uickly imegnitc a unic|uely 
[>owerful solution for our clients thn^ugh the blending of 
numen?Li,s scanning modules. 

We have found that the use of luullipic m{Kiules signiftcanlly 
enlianced the proteaion provitled ttj our clients. Using several 
anti-virus irKKliiles, for example, helped catch new virus 
ouihreiiks faster than a .single .scanner, since each ami-vinis 
vendor m;iy have significintly different lag time Ixiween the 
initial outbreak of a vims, the necessary definition Ixing 
published, and the ii|>daied definition rc^aching our servers. 

When it comes to spam filtering, MPP offered us tlie 
opporitmity to deploy Pattern Aiirhority in addition to 
SpamAssassin. Obviously, any atlditional rt'source tor preventing 
spam is a welcome addition to most server administrators. 

WllAT DOES MPP A<TIIAI.I.Y DO? 

MPP acts as the intermediary in tlie scanning pnxess, taking 
messages from tlie MTA, preparing the message for scanning, 
then handing tlie message off lo each active Dynamic Scanning 
Mtxiule for prtxessing. When .scanning is complete, MPP 
compares the results against the configuration Ixfore signaling 
the MTA with the correci action to lake. 

The architecture of MPP is based on a single Unix daemon 
managing numerous wTirker prtxexses, Tlie niimIXT of worker 
pnxesses can lx configureil tr> handle diffeamt message volumes. 


Lon Baker Ls the foimtler of S]X!t?dymac I.LC, a developer of e-mail services, and web applications. Spccdymac has Ixxn providing e-mail centric 
.soltjli^ms to husinesses of all si^^s for over 5 years. Ltin has been succumbing to Ills Mac addiction tor tJver H yeajs. 
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witli each additional worker process spawniiig ;iiiy necessary 
prtR:csscs needed for eacii active dynamic scanning module. 


MPP 


lltppHonlw Proc*« 
ItaBnnn]: 


MPP W«l»r Pmo*« 


Pvptfstwr 

I 

f^Hiunl Oueuv 


Figure 1 

'ihe ct>nfigiiraiion of MPP is Ijandled via a single text file. A 
Wehmin module, to liandle the niak^rity of conhgtinUion ta.sks 
llirough a Web Hiow.ser, is included, thtjugli tnone advanced 
configuration options reciuire manual editing via the conaiKind line. 

A wide range of processing o)Riotis can Ix" configured based on 
Lite results iwm the scannefs. A messiige may ftjve headers added, 
lx quarantined, lejectcd, dekied, r>r passtd ihrougli Ixused on tliese 
settings, as weO a.s attioas to take should a sciinning error occur. 

Message's Hugged l:>y the MPP cotiiigunifion and ,sc';inning 
results can be quanmtined, which is conmuju for [iiessages 
infected with a vims, and UV? y)rovides for a disk-based 
quanmiine for spam uxssuges, in addition to infected messages. 

Management of quarantineci messages is also handled 
tliroLigh the Wehtnin module. Allowing you to ivview, delete, 
forward, and resubmit ([uurantined messages. The latter is 
helpful in llie event a message is falsely flagged for quanintine. 

One of the most important a.speas of any scanning .solution 
is juaintaining current vims dellnilions. In tills area, MPP offers 
update scripts for llie commercial scanning mcxiules that can lx* 
ujunually contralled through the Wehmin interface. 

'Hie choice HAK made to sujittorl multiple solutions 
through the u.se of dynamic sc-iinntng modules allows greater 
flexibility in bringing new^ engines to Mac OS X server 
administrators. This helps protect our investment, and 
encourage addiuonal companies to support Mac OS X through 
a relationship with RAP potentially. 

DI:PIX)YIMG MPP 

MPl^ can lx deployed on yr>ur mail server, or as an SMTP 
proxy .server. If MPt^ Is deployed ;is an SMTI^ Proxy, a minimally 
configured mail server is rec|uired to handie the SM"[ F services, 
since MPP dtxs not contain its own SM'I'P sc'rver. Some may 
view this as a drawback, l>ut we txlieve ilmi ii is an advantage, 
since it allows MPP to fotais on what dexs Ixst. 

RAF offeis package installers for installing MPP on Mac OS 
X. Though tlie installers are quite handy, they art' not witliirut 
their cxcasion;tl Hawes, and it is highly rcxcjrnmendcd you do test 
installs on a machine not in pnxiuction to insure that the installer 
dexs not overwrite the existing configuration or license files. 


Installation of Ml^P can vary widely Ixisetl on which dynamic 
scanning modules you intend to use. In ihe case of die commercial 
sainners, ItAPl provides native Mac OS X iiisUiller jxickages for heth 
Sophos, and Pattern Authority, while the o]>en S(.)urce .sc:anner.H, 
such as SpaniAssassin, and CbmAV, nxjuiie you to install lliese 
st)lutk>ns separately on the server Frtwn their res|xctive sources. 

There are a few loose ends wrhen deploying MPP. 
Automating virus definition iipclates requires manually treating 
crontab entries to call the provided update scrij^ts. In the case of 
ClamAV, you will have to create or use an update script that is 
provided with the ClamAV source distriliuiion. 

llpdaiing an existing MPP insiiillation is fairly straightforward 
using a .simple TAR archive. The one catch Ixing that you must 
completely stop MPP, and kill any existing prex'esses. This c'an 
leave you vulnerable to un-scanned me-.ssage,s pas.sing dirough to 
end u.sers while I he update is in progress. 

Ttic sup(X)rt for a wide range of M'l'A’s an<l plutfonus allows 
an administrator to mix and match as ihey see fii. In our erase, 
we have our central mail servers airmirig Cumnumigate Pro 
using Mac OS X Server on collocated Xseives, Our backup mail 
servers am Postfix, and handle backup MX for our clienLs using 
less expensive equipment, and htcililies. 

Coni iGURiNG and Managing MPP 
Configuration and managemeni of MPP is accomplished 
through the Wehmin module included waih the product. 
Through this kKil, most canfigurdtkm tasks are performed, 
though a few of the more advanced configuralkm opiums 
require manual cxliting of the configuration file. The Webmia 
miKltde also provides a fully fiinctiomil interface for managing 
cjuarantincd spam, and infected me.ss;tges. 

MPP configuration options are broken into several distinct 
sections: antTvinis, ami-spam, and vendtir s|X"cific options. 7'he 
configuration iif MPP is quite Hexible. having liotli "Scan” and 
"Do No Scan” options, allowing you lo cusUmii^e wdiich 
messages are scanned. The drawback is that these options are 
gkibal, and apply to both anti-virus and anti-spam* 

Tile anti-sjram coiiHgoniiion options incluitc Irasic W'liitelist and 
blacklist settings that allow you lo designate e-mail addresses, and 
doiruiins for racli list. Tlie main drawlxick of these configuration 
options is that they tinly apply to ihe “From:” and To:" lieadeis. 

Ml^P does not manage the <x mil go rat ion of SpaniAssas^sin, 
so yon still have lo manage your ifs configuration separately. 
Since SpaniAssassin configuration is a world in and of ilsell, this 
is not suq^rising or unwelcome. 

When tieploying MIM^ as an SMI F Proxy, the current 
version d(xrs not support managing the configitrations of each 
prtjxy remotely. Vou are, therefore, in the |K>situ>u of syncing tlie 
configuration files etiher manually, or via a homegrown solution 
stK*h as rsync. 

MPP is a ra(>idly maturing prt>duci tfiai ofTeis a fundamental 
clKlice one has to make. Do you coiraiiit to uti^;^j^g tlie product 
to completely manage tiic email filtering? Or, clo you simply allow 
it lo ‘"tag” messages for processing down sircxim? Tills decisitin is 
quickly being shaped by the legi.slative aciioics revolving around 


OimilMiC $Eiifiiikig 
SophM Cf SpWKAKHWi. 
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spam and privaLy. Iki[ it i,s nice to Intve the opticm to determine 
the nieth<xl of management depending on your environment. 

PTiRFORMANCF 

As mentioned earlier, MPP is implemented as a native Unix 
daemon following a daemon/worker prcxuss mode!, which 
alitjws MPP lo grow as yottr mail vt>kime increases sim]>iy by 
adding more pitxesses. If iiiail volume grows lieyonrl the 
rapabiltlies of a single server with MPP, multiple scanning 
.servers can lie deployed in the form of proxy servers. This 
scaling has the ptaenlial to significantly improve peiformance by 
distributing the load across numerous .servers and netw{irks. 

Each aciive dynamic scanning moduie contributes to tlie 
overall performance, memory reejuirements, and scanning speed 
of MPP. As is to be expected, ixTfomuTice tmpatn can vary 
signifiamtly from module to mcKltile. We found that i>asic 
scanning functions [icrfcinned by MPP are highly efficient, with 
overall perhirniaTtce significantly iiii[>aclcd by temaio modules. 

The anti-virus tnodules tend to consume more resources, 
with l^xttern Auihoriiy Ixdng the most resource mtensive. Tliis is 
to be exjxfcted, since Pattern Autli<jrity straddles the roles of 
anti-virus, and anti-spam, unlike other modules. 

The fx-ri'ormance of SpamAssassin varies greatly, along with 
accuracy, bascxl on the configuration of SpamAssa.ssin. In our 
highly ctisTttmi^^cxI SpamA.ssjjssin installation, we have in excels 
of 2<),0(X) c'u.sicjrn rules, 6 individual RBL checks, and customized 
SpamCtjp UUl checks on tile Ixxly of each message. Even with 
all these checks, we see [Processing lime of just a few .sec:onds 
in the most drastic siniations. 

MPP also hel|xxl solved a prcibleni we often encountered 
prior to deploying MPP regarding improperly formed e-mail 
messages. Mld^ parses each message while gatliering tlie relevant 
inlbniuition to apply the configuration to the scanning modules 
results, iTiis aliow's MPP to [Prevent improperly formed messiiges 
from btdng handed off to the scanning modules, Wlikli Ixftne 
MPP could cause emjrmous prtpblems, resulting in a simple delay 
in prexessing, or in a wt>rsi cxscs crashing a stvanner, 

MANAGflVG RfjSITITS 

With Ml^P configurc'd, dc'f>IoycxI, and scinning messages, there 
are a nuiiilxr of chokes for managing rcsulLs. As mentioned earlier, 
the flaggal messiiges am be quarantined on tlie mail server, 
rejected, deleted, or flagged lor routing fiirther down stream. 

For messages infected with a vims, you will mosi likely 
want ihein ciuanimined on (he server, or deleted completely. But 
for mes>sages fiagged as spam, we chose to flag them for 
processing down stream, either by tfie clienL, tjr the receiving 
mail st.‘rver Managing the spam quar^mtine In the curreni version 
of MPP Ls liighly useful and effective, but in our environment, 
did not fit the needs of our clienLs. 

Tile first issue we encountered with the current version of 
Ml^P LS that SpamAssassin results are not injected into messages. 
Tills can make reviewing, and improving Spam Assassin niles 
more tlifficult in lliat you must review mail logs for the resulLs. 
RAB has promised this issue will lx? resolved in an update in the 
near future. 


Anoilier minor Issue resulLs from the lack of a centralized 
configuration option, or management of quarantined mc.ssages 
across multiple servers. With two main production servers, and 
two backup servers, while still more efficient than our previous 
homegrown system, it still leaves us with four server 
configurations, and quarantine areas to manage. 

RAP is working on a soluiion lo part of this issue tliat we 
have tested. This summer, version 2.0 will intrcxiuce a 
cjiiamntine area .stored in a MySQL database. We ho|x; that RAE 
considers storing c:onfiguration information in a MySQL database 
as well, which would help in managing multiple MPP 
in.stallaTions aaoss an enterprise. 

StJPPORT 

ILAE Internet is a growing com[iany, and in our experience 
has cxliibited txah enthusiastic support, as well as their fair 
share of growing pakis. Overall, RAE's .support for Mac OS X has 
Ixen very good, unlike a fair number of far larger companies. 
HAF/s primary support method is e-mail, though it is not difficult 
to get die refreshingly helpful, and honest staff on the phone tf 
an issue calls for it. 

One area that is sorely lacking, and an obvious result of 
dicir rapid growth, is the minimal dfxumentation included with 
MPP, which Is currcnlly limited to the Read Me file, comments in 
the c'onfiguration file, and an online EAQ. RAE needs to focu.s on 
detailed Leclmicral dcxaimennition for Ml^P. As it stands now, 
learning the more advanced configuration oprion.s reqiure.s an 
exchange on the mailing list, or with technical support. 

As an early adopter of MPP, in addition to receiving great 
su[>port, it's Ixcn a plcmsant surprise to see how responsive ItAE 
lias Ix^en to feature requests, and how ra[)idly those requests 
were made available to customers. 

Is MPF WORTH IT? 

MPP is a rapidly maturing product dial offere a gotxl 
answer to a fundamental question an administrator has to ask. 
Do you commit to utilizing a single pnxluci to manage the 
majority of your email filtering, or do you sjxnd die time, and 
effort piecing together a solution on your own? 

The cost of MPP is determined based on which 
commercial scanning moduies you choose, as well as ihe 
number of u.sers. Since MPP is the management platform for 
the scanning solutions, the majority of licensing fees go 
towards the various commercial scanning modules they offer. 
However, MPP can be purchased to integrate with existing 
licenses for supported scanning products, like Sophos or 
Pattern Authority. 

While Mac OS X is our platform of choice, MPP’s liccasc Ls 
not restricted by platform. Tf a company “outgrows" an existing 
platform, or requires larger servers, the investment in MPP is 
protected. The only restriaion is that MPP is only .supptirled on 
Unix operating system.s. 

Widi Mac OS X gaining traction in the enterprise market, 
MPP offers a significant value for those looking for an easily 
installed and managed solution for deploying anti-virus and anti- 
spam filtering. 
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REVIEWS 


By Sean Whelan 

Testtrack Pro 6.1 


Defect tracking for distributed 
deveiopment teams 


OVTRVIEW 

'lestiriick Vm 6.1 is u dcfeti tracking solution for s^iltwarc 
dcvclopniunt and cjuality as^simmce teams that offers user 
customi/.able fields, a workflow aiidil trail, powerful data 
analysis, and oirdeiiiand rejxming, ll is built to scale up for 
large teams wljtj collalx)rate on projects acros^s multiple 
locations, and time zones. TesiTrack Pro is a clienl/sc‘rver 
application with client access frtJin Web l>n>wsers, and server 
supp^m for OS X, Solaris, Linux, and Windows, to addition to 
WVb browser acces.s, there is a Windows client application. The 
system offers customizable workflow actions, ayiomatetl li-inail 
notifications, import / ex|K>rl utilities, and a SOAP SDK for 
sim|>lityjng integration with other applications. 

Kiither than just a defect tracking solution, Testtrack is 
aimeti at filling tht‘ role of a software development life cycle 
Workflow Managenieni Module. Hie ctmibiaation of automated 
notifieaiiuns, Stairce Code Control integnition, and iniegraiion to 
<jther CListomer-faeing Sea pine modules (Sololiug and 
SoloSubmit) that cafnure end-user reported software issues, add 
up to a tool that can be used by all teams involved witii a 
stifiware release from the Subject Mailer ExfKm, and die Projea 
Manager hj ilu* Supjxm. Develoj^ment, and Quality^ Assurance 
Teams. User security is set by Usergroup to control the granting 
of user rights and user access tlown iti the individual field and 
ctmimand level. 

We originally implemenied 'festtrack in the late in its 

earlier form, lesitrack for Workgroups. We have develo|K’rs, anti 
QA staff who work lx ah on Mae and PC machines, depending on 
wiiich product line they are sujiportiiig. At the time, lesttrack 
was one of the few commercial defect tnicking soluiions dial 
offered full clients for Ixitli Mac and W'intlows. Wnh the release 
of 'festtrack Pro in 2(X)0, Ma<.^ users were only able to access die 
server dm>ugh the Web client. 'Hie earliest versions of the web 
client were not hi 11 feaiureti, and caused stime distress for t>ur 
Mac teams. Over rhe Iasi four years, Sea pine has enhanced die 


Web client to the level that it has l>ecxime iht^ preferred method 
of access for many of <nir engintx."rs, regaidless of platform. 
Stnipine emrendy has no plans to re-intnxlut'e a Mac-specifit: 
client, but wall continue to serve all platforms with the web dieiit. 

INSIAIXATION 

OS X installation is straighdbrward and fairly sim^ile. A disk 
image file is automatically extracted from a gz archive, and 
mounttxl on the desktop. 11ie mountt\l disk image contains a 
tyfiical installer, and a ld)r file. The installer prompis for Admin 
credenthtls, tlien iiffers the user two paths for proceeding, an “Easy 
Instair^ ora ‘"Custom Insiall.” Hie e:isy install will load all Testtnick 
componenLs automatically, including die License Server, Lkrense 
Server Admin Utility. Application Server, Web Server Admin Utility, 
Sample Darahase, and the stand-alone eu.sttimer issue reporting 
tool, Solo Bug. The Cusiom Install allows the u.ser the freedom to 
s|x:€ify wliidi components are to be installed, whai server ptins 
are to be used for communinition, and other configuration details 
that are set up as default values in the Eitsy InstalL 

Simple configuration of the server must IX" done to enable 
the Web and Lic'eiise Servers. 'I'he user musi go into tlie System 
Preferences, and set Ixith apfilicaiions to auioinatteally stait upon 
machine siumip. Admin User and License informatkm will need 
to be keyed in to the License Ser\^er Admin Utility IxTore logging 
in to die sample database, or creating a database for your project. 
Sea pine sc'lls its licenses jx^r user seat, and offers the choice 
between named licenses, and “flonTing“ licenses which 
correspond to concnmaii usi;r acce.ss to the server Prices per 
user start at $295 jx-r nattied user and $795 per concurrent user. 

OJLt. _ LicenM ScIVtf Aclflurr UUIKy 
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L /jceme SentT 


Scan Whelan is the Senior Director of Quality Assurance ft>r CommcTCixil Print ITckIucIs at ER, Inc.. I le lends a QA team whose engineers test, and 
release .software targeted to customers on Mae arul Windtjws platforms, as well as testing ho-slcd Web PukIucIs. 
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ClJSTOMIZABIJ. WORKRDW 

One of llie key features of Testtack Prt> (rA is that it allows 
Administnitors to fully customize the produci to fit ilic w<irknow 
needs of the dcvekjpment, siippcjrt, and <:iualit>' assurance 
groups who are using it Adi ni nisi nitons on customize field 
names, contents f)f pop-up field entries, field relationships, 
workflow stages, and the default values of fields, Customizatioti 
includes specifying whetlier or not a given field is required ft>r 
rec'ord entry, nuto-assigment rules, e-mail templates, as well as 
rectird fillers and reports, 'iesttrack allows the user to cafnure 
additional iiifonnaiion bcyt>nd ihe standard defect irackmg fields 
through the creation of unUmited custom fickLs. Two Caistorn 
fields can In.* added to the main screen, while additional fields 
aiie added to the Custom Fields fab. Custom fiekis are not 
restricted to text values, hut can Ik^ added with any of the 
standard field types, including: date, integer, text eniry, and jxjp- 
up menu with customizable entry values. 

Customization is achieved by sc^lecLing options from stripped- 
down, eas 7 'K>-iise configuration screens. The cusiomiziiiion Ls so 
simple tliat you could have junior level support stall' customize 
your cliitalTase (not that you would want to, but ii is that simple), 
Aatnher advantage offered by Iesttrack Pro, as compared to mmv 
odier defect tracking systems, ts that it is not nec'essary to take tile 
server offline w'hile adding, and editing aistom fields, or field 
values. This work can l>e done while users are logged in, which 
can cut down on I lie lime spent tioing Admin tasks after^houis, 
and minimize the need for planned service outages to make 
uptbites. Ihe only customization tasks tliat rer|uire a kx k-<>iit of 
all users are deleies of fields or record entries, as they may lie in 
use at the time of tlie deletk>n. 


• eo 



Figure 2 Adding Cnsiom Fields 


WoRKLNG Wnti Testtracic Pro 
The web server is typiaiUy hosted as paii of your intranet, 
and users in yt>ur domain can reach die service from a URL that 
you configure in the Systeiii Preferences of your serv^er, such as 
http://testtrack.mycompanyn3nne,com. 


Upon liigin, the user sees a relatively clean home screen 
that offers navigation links acTos.s ihe top to screens for Defeas, 
Wfirkbook, Customers, Users, Security Groups, Test 
Configuntlions^ Filters, and Reports. Along tlie left side are links 
for actions dial ciin lx.‘ taken on whatever record or list tjf 
records are displayed in the main screen, such as Assign, Fix, 
Verify, and Close. Ihe user only sees actions and links ui which 
he/slie has security rigliLs. A developer user may lie set up with 
rhe right to Fix defetts, I>liI not to Verify them, a QA engineer 
miglu have rights to Verify defects, but not id Esumate a Fix. 



figure i Main Ik^ects Screen 


Defect Entry is straightforward. The com!)ination of industry 
standard fields such as Sumimry, Description, Severity, and 
Steps to Reproduce can \se. augmented with the addition of 
wiiatever cu,stom fields your workilow desires. New to the 6.0 
version is the ability to cu.siomize the workflow steps tliat a 
defect gtK.‘s thniugh during its life cycle. In the past, Testtock 
Pro limited records to tlie main staie,s of Open, Fixeci, and 
Closed, With subsets for review status, and staff assignment. Now 
system administrators tan enhance the workflow to include 
whatever additional steps might l>c nece.ssary, such as ^X'iaiting 
For Build, or Pending Management Review. 



Figure 4 Lkfeci Enln^ Screett 
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The displayed columns, and sort order on list screens for each 
user are adjastable. The last settings saved are kept on the server, 
,so dial die user can ,see a consisient view when logging in from 
different machines, or witli different browsers. Users and 
Administrators are aiile to create filters to slice anti dice die defect 
list any which way to include or exclutie nx’ords Irased on attributes 
of any of the fields. Fillers in use on a typical projea would include: 
My assigned items. All Ojxm Defeas, High Prioriry^ Items, Items 
found in last day, and ;iny number of other ainil jinatioas lyased on 
Status, Dare, Produd Line, or oilier delect infonnation. 

The defea database can be queried with a quick search on 
summary and description fields ora complicated searcli using an 
advanced query builder. Tlie quer)' builder walks die user 
through selecting search criteria. Useful queries can lx^ saved 
and turned into filters for later use by the individual, t>r to Ix’ 
shared with a group. 

Server perfomianee remains good across the WAN for 
groups working remotely from the server, and we have not 
experienced a performance drag despite having tens of 
thousands of entries in some databases that serve multiple 
prixluct teams. The administrator has the choice of t'ombining 
projects in one database, or creating separate databases for each 
project. New* databases can lie buill using previously custoniizetl 
projects as lempiates. 

There is an import utility to move data from other systems 
into a new 're.sttrack Pro database. Comma and lab Delimited 
text files am be imported direelly. The import interface allows for 
the rnaptdng ofimixirt columns to die destination columns in ihe 
pmgrant The mappings can lx preserved in an ini[iort template 
for future imports of text files from the same source appliaition. 
'Pliere is a sixrified XML record fonmt that allow's for direti 
imjKirt, and ex|X)il of data from other Tessiint k daiabases. 

liditing a defect record places a lock on the record, making 
ii unavailable for editing by other users. Locked out users c an 
retrieve information to identify who has ihc? rei*ord kxked to 
avoid bottlenecks lhai may occur when a record is 
uninieniionaily left in edit mode. User sessions have an idle 
session timeout that is ecmfiguretl under ihe Server Options 
Section of the Server Admin ukiL 



Figure 5 Sem^ Admin Sen^n 


AiirDSfATED NonncATioisis 

One useful feature of Tcstirack Pro 6.1 is its automated 
H-mail noiificaiion system. During set-up, the project 
administrator can identify the workflow actions tliat cause e- 
mail notification, and to whom. Noiifications can be sent 
using Testtrack Pro’s internal notification system, or using 
SMTP or .MAPI e-mail. The e-mail notification templates can 
lx* cu,stomized to contain pre-defined text, as well as values 
from the defect record. Project managers may choose to 
receive noiificaLion for every new defect entered for their 
projects, while individual developers may only want 
notification when a task is assigned to them. Additional users 
can l>e added to tlie notification for a record for situations 
when a high priority issue comes to the attention of those 
higher up in the food chain wlio would normally not be 
included at that level. 

Get at the information 

Basic On-Demand rcfiorts are included with the 'lesttrack 
Pro inslallalioti. Reports can be customized using the reptat 
ctnifiguration menu, and they are formatted using included 
XSL (Extensible Slylesheei Language) files, which can be 
edited in the pn^graiii itself, or replaced with your own XSL 
files. Tliree report types can he created by the user: detail, 
list, and trend reports. The trend repons are supposed to 
show actions plotted over time, such as defect rates reported 
during a specific peii<Kl, l)ut we have never found them to be 
much use, largely due it not being clear what criteria were 
used in adding up ihe trend eouiiis. The list reports are easy 
to sei up and cusioinixc, and are essential for defect review 
meetings, and release planning. Tlie same report generation 
engine is engaged to autoniaiically build release notes based 
on a release level. Like die main reports, release notes are 
fufly cusunnixable as to their content, anti format 

PliSH DEFECT mi%Y OlfT I'O THE OlENTS 

Scapine allows teams to extend the reach of the defect 
database out to their clients. Testtrack comes with a 
.standalone defect entry application called Snlobug that is 
extremely ligl it weight, and can he sent out ui ai.sioniers, or 
anyone who is not ci^nnected to the server's network, but 
wliose feedback on .sofiw'are issues is valued. Solobug runs on 
OS X, Palm OS, and Windows, and i.s customizijble as u> the 
fields it contains, the values for those fields, and which fields 
are required for siihmission. A Solobug user saves the output 
file from Solobug after defect entiy, and e-mails it to a 
designated address .so that it can be reviewt-d, and imported 
into lesttrack, if de.sired. The customization of Solobug 
includes prtwision for entering end-user instructions, and 
directioHLS on where to submit the Solobug oil [pul. 

SolosLibmit i.s an add-on to Testtrack i*ro 6.1 that allows 
customers to enter defects and feature requests into the 
Tesilrack database through a web page. As with Solobug and 
Testrack, the fields, field names, fieki validation, and other 
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Items are easily aistomi7:ah!e. 'I'esttrack/s workflow can be 
configured to segregate items entered through Solobug and 
Solosubmit, so that they are not entered into the 
development workflow until they have been reviewed 
internally. The intention of these tools is to lower support 
costs by allowing customers to enter items directly into your 
issue tracking system without having to teleplione a support 
person, and without having to re-key the information from 
an e-inail. 

Tfsttrack SDK wrm SOAP (Simtie Objh:i' Aoess Protocx>l) 

If the team's workflow requires integration to a third party 
CRM tool (such as Sielx^ or SAP), or other in-housc project 
maniigemenr or customer service system, the Testtrack SDK 
allows access to Testtrack features, and data through the SOAP 
programming interface. The SDK ships wiili platform 
independent SOAi^ client licenses, a Testtrack f^ro SOAP 
Programming manual, and a set of examples for such tasks as 
entering records prt)granunatically. W used the SDK to build an 
integration l:)etween our Pesttnick Pro databases and our CRM 
system so that the Customer support teajTi could enter records 
directly from tlie CRM system screen through a punch-oui, and 
automated log-in to testtrack. 


Conclusion 

Testtrack Pro 6.1 is a comprehensive defect tmckiiig 
soitition iluit offers software devekrpment groups an affordable, 
scaleable, and relial>lc way to manage defects, and 
enhancement requests throughout the softwaie development 
life cycle. The ease of custom i rati on, and low cost of server 
administration, make it a Uxd tliat can fit the needs of the 
smallest team, up through the Iaige.st, geographically distributed 
development group, 

Seapine Software, the maker of Testtrack Pro 6/1, markets it 
as a “feature complete" defect tracking solution that can help 
reduce is.sue turn-around time, reduce time spent on project 
management tasks, and improve ckiy-to-ckty communication for 
distributed teams. The automated notiJications, comprelien.sivc 
security settings, and On Demand reporting have helped our 
development and QA teams to stay informed about all issues 
regarding a release cycle, even when working from different 
offices and on different schedules. 

The speedy performance of the Testtrack server allows us 
to host the databases in one location, and allow access to 
Development and QA teams distributed across North America 
and Europe, ft allows our engineers to coIla[x>mte across 
disiances, and tias liccornc an integral part {)f our workflow. 
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REVIEWS 


By Inrin Ritters. Bon-vivant and Raconteur 

Laptop Backpacks 


A roundup of some of what's available 


WtLCOME 

If you have a laptop, you need a way to transport it. A 
tronveniional briefcase or backpack jusl (.kx.‘s not oficr the 
prtJleciion your extremely valuable hardware deserves! After 
carrying (at some times two) laptops all over the US and Kiirope 
in a shoulder bag, and suffering the discotnforl tlie uneven load 
prtxluces, I ihouglit I'd try a backpack instead—and Vm glad I 
did. The woiT^t thing about backpacks is they are tlorky looking, 
but 1 doubt rii go back to a shoulder bitg for lugging my kit 
around- MaylK* someday I’ll Ik: rich enough to utTord a laptop 
Sherpa and won't have to wony about it.*.* 

1 used seven different backpacks from as inany 
nianutaclurers for at least a few days each. 1 liave a liighly 
mobile work life, and live in one of the most unwired cities in 
the US (Austin, 'IX)-1 thrown my poor battered I'iliuok into a t>ag 
several times every day. 



fijiure 1 


7bp li) ng/j/; BreiilhaiJen Professioml /5" 

Shatw Jackson Design BackOffice. 

Willow Design Jacc^tes 15"*, HP3 Syskmi 

Bottom mw. kfi to fight: Targus SiX)rt Deluxe, 
TimhukJ Detour, Spire Volt 


That’S Not My Bag, Baby 

No, Tm not going to use the "Which bag would you want 
if you were trapped on a desert islantr c:liche (die bag witli 
the satellite plume in it, thanks for asking). Instead, each of 
the bags fills a particular niche as it turns out, as I'lJ explain 
in more detail. 

Cadhjac Bag 

Hands down, the best all-around bag in ibis collection is 
the Brenihaven Professional 15'* http://www.brenthaven.com, and 
ai S170 MSRF, it ought to be. That said, ft’s also the one Td 
pay for with my own money if I were to buy a new laptop 
l>ag. 'fhe con.simciton is very solid, and matenals are 
top-notch. Tile aim/aug thing about the IJrenthaven is its 
capacity^—somehow, they’ve made this bag far bigger on the 
inside than on the outside. With .six cioseable pfickeis, and 
numerous poucljes, tlierc's a [>lace for every piece of kit you 
might have, and ail easy to get to. It's not that it's a large bag 
at all, it's just very well designed. Hefty padding on the 
fxHtom of the hag, plus a sturdy removable inner sleeve, 
ensures the safety of your machine. It has strong, 
comfortable, quick^adjust shoulder straps with perforated 
covers to promote airflow and cooling* The straps have rings 
and hoops to attach accessories to (cell phone bags, and 
what not). This is the bag 1 always came back to, and the one 
I alway.s chn.se when traveling. In several months of hard 
use, the cmly visible impact is the finish on the ;^ipper pulls 
is starting to wear off. t recommend this bag without 
reservation to anyone. 


Lorln k a long-Ume Mac user wiilj nXH.s in the NltXTSTHP conununiTy <he was a key memlier of the Altsys Virtuoso teaiii), a former Macromedia 
evangelist. I^ower Gumputing Poweribwer l^ro Product .Manager. Vicc-l^rcsident of Markeiiog for REAL Software, anti is cLirrently Acaiunt Executive 
for MacTech Magazine. 
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Hgure 2 

Inimorof the wiib sieein^ Lieimi, Nnlt* ibt* 

numertnis pouches and places to stow things—the pouch for the 
slcetfe has a large documefit slot and the inner compartmeJil 
has six pouches, two mth elastic tops. 


CoMMirTER Special 

Tlic Sliaiin Jackson Design BackOffice 
<hUp://www,sjdesignxom/backoffice,h is u unkjuc piece, and if 
you commure by train or bus, or work frequently without ready 
access to a table or desk, iliis is the one for you. Ihis bag is aiso 
snjrdy, and well construcied, as you'd expect frcjm (me at ihe 
higher end of the price range at $149-95 MSKR 



figure 3 

tiack(.}ffice inrtually deplo\ed, Were are turn pads for elemting 
the hack of \mir 7i(x^k forairfioui Ihe side^ which drape on 
either side of your lap as ymi use it are easily accessed while in 
imc Takes almit one second to clcm it up and go. 


While it's ideal for the type of users I mentioned, it doesn’t 
liavc mitt'll in the way of storage- it'-s also one of llie more 
compaa bags I looked at. 1 enjoyed using it around the hoiLse 
t<x), since I have a thigh-frying I'tliook. 

Expedhion Grade 

The Willow Design Jacques 15” 
< http://www.willowdesign.com/PK-10.html> is the bag for those 
wlio lend to he hard on ifieir gear, or live a rough and rumble 
life. If you want to bring your laptop along for the ride and 
stlli be ai>le to use it after, this is for you. I've never felt my 
machine was better protected in my life. When it's ail in 
place, this bag has bank-vault solidity, and it’s qttite compacL 
as well It’s truly amazing- '^ou can also use the sleeve as its 
own bag—it's got its own shoulder strap and some 
companments of iLs own. 



Figure 4 

Ihe sleeve forthejaapies, strapped in. 

Tile other disiinguisliing failua* of the jaeifues bag is the 
conspicuiry factor. There are reflective strips all over the place 
on the ouLside of the bag, and the sleeve. If I liad a kid who rode 
a bike to school (or skatelKiard or whatever), and had their owm 
laptop, this Is what I'd get for them- At $170, it's not cheap, liut 
that price includes the sleeve, and wath laptops averaging $2000, 
not a bad [nice to pay for llie level of proteclkm this bag offers. 
Tor what it's worth, the Jacciues was a close second in my 
opinion. My only complaint was that because the zipper goes all 
tlie way to tlic Ixitlom of the sides, the front part of the hag had 
a tendency to flop open and if it wasn't all buttoned up stuff 
would fall out- 

Qool Factor 

Next, and pretty much tied with the Jacques, is the Bocxi 
BP3 System <http://www,booqbagsxom/Detail.bok?no=44>, This is a 
very cool looking, and custoiiiiziilile bag. The System includes a 
shell, a sleeve, a PDA case, and a plione case in addition to the 
hag itself. At $159.95 MSRP, it's a pretty good deal Carefully 
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coriNidcr lliis unit if you spend much time listening to an il^od 
due to the handy Media Jack, which allows you to thread your 
headphones through a grommet 



Figure 5 

Big black Bom/ iPilb orange shell 


The R1^3 intrudes some great lealures (sucli as tile 
Mediajack), loLs of storage, sturdy design, very comfortable 
scraps with a siernum strap (this keeps the shoulder straps 
securely on the shoulders, and makes rarrying lieavier kuds 
more cotnfonable), and hip ]>adding. It also has an innovative 
p<x'kei for storing documents on the side of the bag—stuff slides 
between the padding against the wearer's back and the lining of 
the main euiti part men L The bottom, and back surlaces are well 
padded. Tile PowerSleeve is a rugged, padded enclosure for 
your laptop, and BofX] offers them in 12, 14, IS, 16, and 17 in. 
sizes. Tliey spun shoulder stnips, / 4 ]>ixTcd compartments, and 
heavy-duty jiadding. 

BiroGET Model 

1 suR'er fixan dtampagne taste on a Ixier budget. Ihe Targus 
Sport IXduxe <http://wwwaargus.com/us/prc>cludJetails.asp?skU“TSB315> 
b wholly adeiiuate, lajge, and C|uiie comfonaliie lo wc’ar, witli well 
paddcxl back and straps (which also Irave a stemuin strap). I found 
it to be priced very fiiirly at $79.99 MSRP, It might lie hanl to aigiie 
that the more expeasive liags are twice as gcxKl as the Targus, hut 
I’ti recommend this only for people on a very uglil Ixidget, or who 
only want lo use ii iKag (xx’asionally. 



Figure 6 

My stuff kept falling out of the outer {HKkei of the Targus 


Messenger Bag AND Backpack 

I am a l>ig tan of 'i imliuktu prixlucts. I have had one their 
messenger bags for years. They alstj have a great, and 
emertaining website. 4’he TimhLik2 Detour 
<htlp://www,limhuk2.conn/detOur.t2> is a fantastic messenger bag, 
way Ixtter than the clas.sic ihui I have—it's padded and has a 
handle, 1 just found it hard to use as a laptop bag, c^en with a 
sleeve. I like compartments, thougli, which is reflected in how 
much I like certain bigs in tins roundup, 7he DeUmr also suffers 
a little from the “neither fisii nor fowP [irolilem. It's got these 
vestigial straps, but it's not wide and shallow like a regular 
messenger bag, it's sort r>f square. 44iat said, itb definitely ccxjI 
kxiking, well matle, and stylish. If you are kHiking for an all 
purpo.se bag that you sometimes jxit a laptofi into, this is one to 
consider strongly, Ixcause it's ]>riced reasonably at $100 MSRR 



Figure 7: The TkiUmr 
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The Timbuk2 sleeve is fanULsdc — sioullt piicldin^ than any 
of the others, while not tiyjtig to Ix^ a bag inside a l>ag (with no 
shoulder stixp or extra poekets). 'the one they sent for review 
was this crazy electric purple (Mariposa Purple) that is beautiful. 
It is priced at $50 for simll, niediunu large and XI. and $60 for 
XXL (for 17" Books). 


Glow in rui- Dark! 

ITis hag has the coolest zipper pulls ever! Tliere are sturdy 
plastic Ijuttons attached to c{>rd and tied to each conventional 
pull and they glow in lire dark! 1 am easily amused.... 



Figure 8: Ihe white part glows 


The Spire Volt <http://vvww.spireusa.eom/productsA/L3.htnil> is 
iiiuch more of a letlmical backpack tlial carries a laptop really 
well. It has things like a real liip strap with padding, well padded 
shoulder straps with a sternum strap, lots of places to iKiok other 
things to, and a grommet similar to the Booq for passing a 
headphone jack tluough. 



figure 'fhe Bool Delujce, the dmder 
and the inside of the Volt 


What sets the Spire Volt apart is tlie security (hut differenl 
from the Jacques). I felt like it was so strapped, in nothing w^ould 
shake it. There are two cinch straps around the body of the bag 
(you can see the to[3 set's buckles clearly in the group photo), 
so with all that hooked up, it's going nowhere! Tiie laplof) 
pocket is lined with Velcro loop (the fuzzy side). Then there's 
another divider tnade from a hard, hut flexible material, and 
covered with ballistic nylon. Tliis protects the bottom and sides 
of ycjiir machine unlike any of the other bags here. You cm fit 
the divider j>reci.sciy iu your laptop because the sides have 
Velcro hook stuff on them. For even more protection add the 
Bcxit Deluxe <tittp://www.spireusa.com/produas/BT3,html> which fits 
into the divider in a clever way. The sleeve has a shcjulder strap, 
handle, and a zippered |xx:ket. My only nit to pick is that it was 
a little hard to get the laptop in and out of the sleeve with the 
sleeve in the [>ag. At $115 MSRF for the Volt, and $30 MSRF for 
tlie Deluxe, this rig is priced reasonably. 

iovfNG Each One Best 

OK, [ didn't really slam any of tlieiii Ctliough a ctmple 
rightfully deserve kudos). You really can't go wrong with any of 
these l)ags unless you choo.se the wrong one for your needs. 
Some of these are carried at national computer ,stores, and 1 
encourage you to really check them out IxTore throwing your 
money down. 
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PROGRAMMIMC 

TECHNIQUES 


By F.C. Kuechmcinn 


basic Cons BASIC 


Using a Macintosh to program little 
control computers in BASIC 

History Ijisson 

Back in The prehistoric cktys of desktop fonipuierdoin, the 
late 1970s artel early 1980,s, the BASIC interpreter seemed 
ultiquitous. The original Apple Jt came with a fas! integer 
BASIC» which was displaced by ihe Miemsoft variant, 
Applesoft. Commodore and Atari also shipped their 
6502’based computers witli Microsoft interpreter variants. On 
the IBM-lntel-Microsoft side of the tracks, MS-DOS ,shi[)ped 
with GW-BASIC (evenlitally replaced by the QB interpreter, 
whidi copied its core technology from BAS1C09 l>y Microware 
of Des Moines). Although differing in detail, these early 
interpreters had many things in common - including line 
ntniibers and all-global variables, 

Altitough this type of language has long since Inien 
sui>erceded for desktop programming, iliere is a signirit';mt 
market in small emlx?ddcd controllers running BASICll 
(Molon)la M68HClj processors) and BASIC-5Z (Intel B052 
family). Initial purchase casts are low^ and development rapid, , 
Controllers are available in a variety of configurations from 
coiTi[>anies like MicTomini and New^ Micros. Using a 
lTSlMt>-serial adapter or serial port PCI c'ard, these [x)ards arc 
easy to program and run with modem Macintoshes undei- OB-X 
and offer an easy route to hardware fiddling. 

While some folks may ihink interpreted BA.SIC is a toy 
language with no serious applkalions, that's far from the 
ease. Mieromint, for example, has been selling interpreted 
BASIC controllers in industrial markets for nearly two 
decades. Several years ago I implemented the control section 
of a gale and harrier sysieni used in fish hatcheries — based 
on Micromint HU52 hoards programmed with *-2Sk of 
interpreted BASlC-52 code. 

Figure / shows a typical small controller that runs BASIC, 
llie Motorola M68IICll-^xised Micromint R'lC-HCll. Fif^urc 2 
shows a menil^er of the New Micros NMn'/X-020 family. It 
runs the liASICtl interpreter. B^ith Ixrards are shown "bare^ 


without die stacked I/'O cards included in a typical instaharion. 
Details of tliese boards as wed as the companies’ other BASIC I 
offerings can l>e obtained l>y txmtacting die companies at the 
addresses at the end i>f tliis article. 

Now, l>ef<)re you check the cover to l^e sure you're 
reading a Macintosh maga?:ine,, we1! get to where die Mac 
comes in shortly. 

Short programs are easy to create in unstructured BASIC, 
but problems appear when line numbers and all-global 
variables are combined with large programs. In order to 
create maintainalile jiragrams 1 adopted some assembly 
language technique.^ in WTiting a de.sktop computer program 
to convert unnumbered .source text to ntiml>ered BASIC. In 
the source iexl, variable names are managed via an equate 
[aide, making it easy to avoid global variable problems, and 
branch destinations are labels. 1‘he source text can use 
meaningful, i.c. long, variable names, while the final code 
uses one and two characters. 



figure /* Mkmmirtl RlV-iiCl 1 


My first conversion program was written in structured 
Power BASIC under DOS in tlie i980s. It was later translated 
to Borland Pascal before being ported to Mac Pasc:al. The 
most recent versions are in Code Warrior Pascal and REALhasic 


RC. Kuechmann is a progra.mmtT, hardware dtrsignt-r anti tuffet: drinker wht> once lived in Chicago and lia.s lived in Vana)nver-NOT-CANAI9A 
Wasliington for many years, He can be contacted at bosedenage@eanhlink.net 
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5.5, both carbonized and running under OS-X. In this article 
ril focus on the KIiALbasic variant, hence the name basic 
Cons BASIC. 



Figure Z New Micros NMriyX-020 



Figure J, Scree}ishot following conversUm 


At the bottom is sixth EditField Control that functions as a 
message window. 

A short example that follows illustrates the programniing 
approach. Complete sourcefile instructions can l>e found in the 
file basteConsBASiC sourcefiles.doc. 

The following program toggles the onboard h.E.D. on a 
MiciT>minL RTC-HCll once each second for an hour. Listing 1 
shows the contents of the source file, created with an ordinary 
ASCII editor such as BBEdit ortlie Code Warrior IDE's editor. The 
underlying syntax is that of BASICIl, and the hardware 
addresses s]>ccific to the RTC-HCll. 


blinky.sK- 

rem 

rem blinky program 
rem 

%bit5 .equ $20 
%index .equ x 
. equ im 

^blinkaddr ,aqu $bOQ9 

pok^ (Hbliiikadrl r. %bl 15 ] 

: 'set to blink 3600 secs [1 brj 

%lntlex=0 
gosub tfbllnkit 
snd 

I reiD 

I rem 

’ skip numberlfig to line 500 

500; 

I rem 

* toggle the state of the l.e.d. 

‘ each second iising the time fiiricLioEi 
blinkit: 

while %lndex<%tlmit 

portd=portd.eor,lbit5 : ' exclusive-or to toggle 

tl!ne=0 

while cinie<l 

eiidwh 

%indexHtindextl 

endwh 

' skip to 900 to rts 

900: 
return 
j rem 
I rciQ 


ttgt4^re 3 is a screenshot taken following conversion of a 
short iirogram called hlinky, which will I>e discussed furlher 
lielow. TTiree black rectangles upper right are REALbasic 
EditFiefd Controls that display the lime conversion started in 
Z^-liour formal, the time it finished, and the elap.sed rime 
between, in this case three seconds. Below that are EditField 
Controls showing lines in and oitl for tlie most recent pass 
through the flies. Since the final pass checks the has file for 
unconverted labels, the our figure is zero. 

The big black rectangle with the scrollbar is a REALbasic 
List Box Control holding the output of hasicConsBASiC's 
three read-write passes starting with the source file. From a 
source file named blinky.src, bmicConsBASIC creates the 
files blinky.par, blinky.num, blinky.bas and blinky.dmp. The 
par and num files are scratch files, has is the file you load 
into your contndler, and the dmp file is the saved contents 
of the list box. 


listing 1 . blinky.sfc 

Listing 2 shows the contents of the file hlinky jyjs that is 
created frtiin blinky.src by the program basicConsBASIC 


biinky.iv.L'* 

100 ram 

110 tm blinky program 
120 rem 

130 poke(Sb009H$20] 

140 lm=3600 
150 x=0 
160 gOBub SIO 
170 end 
ISO retft 
190 reut 
500 rcni 

510 while x<lm 

520 pc3rtd“pQrtd.eor.$20 

530 tijie=0 

540 while tiine<l 

550 endwh 

560 x-x+1 

570 endwh 
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900 return 
910 rem 
920 rem 


Uniting 2 i Wtnky.bas 

The converted program is loaded into the controller using a 
tenninal program like Z'lerm. After testing and debugging , the 
BASIC program can, in many instances, be easily steered in 
EPROM or EEPROM or non-’Volatile (battery’-backed) RAM 
Microniiiit’s BCC-52 series controllers can burn programs into 
EPROM, while some New Micros M68HC11 lioards are easily 
fiLicd with EEPROM storage. 

The Macintosh program 

The program hasicConsBASIC is a relatively simple text 
jjurser that uses the BASIC language's excellent string 
manipulation capabilities. On the initial pass through the 
source file the contents of the equate table arc saved in two 
giol>al string arrays. Array gEQlubelO holds the labels and 
gEQsubO holds the replacement strings. For branches 
(GOTO and GOSUB), the array gBrancliLablC) holds the 
labels and gLineNumStK) stores the line numbers that 
replace the labels. On the first pass, through the sre file, the 
appropriate strings are assigned to the arrays; on the next 
pass (par file) the BASIC program lines are searched for 
strings in the gEQlabelO and gBranchLabl () arrays. Any that 
are found are replaced by the corresponding (same array 
index) Mrings in gEQsubO and gUncNumStrO. 

Listing 3 shows the method that processes the equate table, 


Listing 3* 


Processtiqu 

Sub FrocefiflEquCbyref textllne afi string) 

dim tempProgLine* equT.abet, equBub As string 
dim equotePos, cquPoSp bowl ong As integer 

squotePgs - lustr(textline. gkSquate) 
if squotePos > 0 then 

// diop yff cumment 

tempProgLine = Left{textline, squotePos - 1) 
else 

tertpProgLine " text11ne 
end i f 

equPos = Insti;(teJflpProgLlne K ".EQU") 

Dec (equPos) 

// get left pan of cqu Ime 

equLabel = Left (tempProgLine, equPos) 

StripCon (equl^ebel] 

gEQlflbel (gEqlx) “ Trim (eqiiLabel) 

// then get assignment text 
howlong ^ Len{LempPtogLine) 
howiong = bowiong - (equPos + 4} 
equsub = Kight{tempProgLiiie. howlong) 

// strip control cImts 
S tripCon(equsub) 

// assiga tt) swap army 
gEQBub(gEqTx) = Trim (eqtssuh) 

Trsc (gEqlx) 

// make line unmimbered 
textiine = + " " + textline 

End Sub 

hasicConsBASIC is derived from an earlier Pascal 
program called, oddly enough, PascaiConsBASIC\ The 


languages are syntactically and structurally so similar that 
converting Paseval to KEALbasic consisted mainly of pasting 
the code from each Pascal procedure or function into a 
KEALbasic method, then making relatively minor changes, 
most of which ciin be accomplished with global search and 
destroy sequences. All insmnees of change to ^'end;" 
becomes "end”, and "begin” is simply removed. "Case x oP 
mutates to “Select case x". 

One of the biggest differences lx:tween die initial Pascal 
program and die KEALbasic versicjn lies in tlie main program 
loop. In Pascal the loop is visible and explicitly created by the 
programmer; in REALbask: the loop is implicit and hidden. To 
illustrate let’s assume weTe making a program wliose actions are 
controlled by buttons labeled This, That and Quit. A Pascal main 
loop might book something like Listing 4. 

Listing 4, 


Fasciil iiixiiv loop 

Repeat 

If ThisButtonWasClickedO then 
DoThisG 

EIrg If TbatButtonWasClicked0 then 
BoThatO 

Else II QuiiButtonWasClickodO then 
Kxitflag:=true; 

Until exitflag ^ true; 

In REALbasic, the Action mcthtxls of the three buttons call 
the DoThis, DoTliai and Quit mediods, respectively. Like the 
Wizard of Oz, the little man behind the curtain keeps an eye 
on the buttons so the programmer doesn't have to. See 
Listings 5 through 7. 

Listing 5 


ThtsButtonAaion 

Sub ThisButtun.ActiuiiE) 

DoThis{) 

End Sub 


Listing 6 


ThatRvinon.Actitm 

Sub ThatButton.ActionO 
DoThatO 
End Sub 


Listing 7 


QuitBuuon. Action 

Sub QuitBjtton.Action0 
Quit 0 
End Sub 

ITie program hasicConsBASIC Convert button's Action 
method calls tlic method Main in listing 8. 
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Listing 8 


Main 

Sub Main () 

dim Eiourcefilc As foldetltem 
Dololt 0 

soMrceflle = CetOpetLEglderl tern ("TEXT") 
if sourcefile <> nil tbeo 
ProceseSource (eourcefiie) 
end If 
end sub 

If the foldcriLcm returned by KEAlbask's 
GetOpenl'olcleiiteni method is valid, the ProcessSouac metliod 
is oiled. 


Listing 9 


wBASIC.l^fOTiessSouiTce 


Sub FrocessSource(eourcefiie As folderlteml 
dim fiiaffie. conbaspath. outpath, eKt As string 
dim timeOut» dateStr. timeStr. lapstr As string 
dim btlneOut.bdateStr, btimeStr^ mess As string 
dim inflle. outfile. conbasFolder as FolderTtetn 
dim flaglf flag2 As boolean 
dim Instrm As Text Inputstrearn 
dim outstm As TextOutputst ream 
dim index, begsecs, tinaecs. lapaecs As integer 

// wlicrt^ arc wc? gel cunvni dir 
conbaaFolder “ GetFolderItem('’") 
conbaspatb “ conbasFolder.AbsoluteFath 
fn&m ^ sonrcoflle.Name 
// get datc/rinic 

btlmeStr - CurrentTimeString( ) 
bdateStr “ CurreniDaieStringt ) 
mess = ’"Converting eourcefiie i " + fname 
fname - StriptExtentionCfname) 

// open tile dmp Ilk 

otitpatb " conbaspatb + fname + ’’^dmp*’ 

flagl * DumpFileOpen Coutpath) 

flagl “ false 

index “ 1 

do 

select case index 
case 1 

inflie ■ sourcefile 
outfit0 ^ nil 

inatrin = Inflle.OpenAsTextFlle 
If itistrm <> nil Llien 

outpath = conbaspatb + fname 
ext “ ’’^par” 

fiag2 ^ MakeOutFile (outpatJi,exr,outstrii) 
if fUg2 then 
// handle err 
exit 
end i f 

flagl ® MakeParfile(instnn, outstrm) 
flagZ * CloseFiles Unstrni. outstrti]) 
else 

// handle err 

flag2 true 
end if 
case 1 

Infile ” GotFolderlLem (outpath + ext) 
if infiie “ nil then 
exit 
end if 

instrm inf lie. OpenAsText File 

if instriD <> nil then 

outpath ^ conbaspatb + fname 
ext - ".num* 

flag2 ' MakeOulFlle Coutpath.ext,oulsttii) 
If flag2 then 


// handle or 
exit 
end if 

fiagl “ MakeNunFile(instrm, outstrmj 
flag2 “ CloseFiles (instrra, outstrm) 
else 

// handle err 

flag2 = true 
end if 
case 3 

infile = GetFolderltem (outpath + ext) 
if infile - nil then 
exit 
end if 

Instrin = infile.OpenAsTexiFile 
if insttm <> nil then 

outpath = conbaspatb + fname 
ext = " . bas"" 

fiagl = MakeOutFile (outpath *ext .outstrm) 
If flagl then 
exit 
end if 

flagl = MakeBasFlle(instrm» outstrm) 
flag2 = CloseFiles (iostrm, outstrm) 
else 

flag2 = true 
end if 
case 4 

Infile = GetFolderltem (outpath + ext) 
if infile “ nil then 
exit 
end if 

instrm ^ inflie.OpenAsTextFile 
if instrm <> nil then 

flagl “ CheckBasFile (Instrm) 

Instrm,Close 
end if 
end //select 
Inc (Index] 

loop until (index > 4) or flagl or flag2 


tIraeStr = CurrentTimeString( J 
UpdateBegTime (btiraestr) 

UpdateFinTinie (lioeSir) 

begsecs ^ TineStringToSecs (btimestr) 

finsece ^ TimeStringToSecs (timeStr) 

lapsecs = finsecs - begsecs 

lapstr “ SecsToTlmeString (lapsecs] 

UpdatcLapsedTlme (lapstr) 

if gDumpFIleOpenFlog Ihen 
dateStr CitrrentDateSlring( ) 

WriteLineToDumpFlle (mess) 

mess = "Beg : " + bdateStr + " '* + btimestr 

WriteLineToDumpFiie (mess) 

mess “ "Fin : " + datestr t * « } timestr 

WriteLLneToDumpFile (mess) 

WriteLineToBuipFile (*'"] 

WriteUneToDumpFLle (""*) 

mess “ "Elapsed Time : "* + lapstr 

WrlteLineToDumpFile (mess) 

WriteLineToDumpFile («’■) 

WriteLineToDumpFile ("") 

WriteLineToDumpFile (”") 

WriteLineToDumpFile (""') 
gD ump St r eam. c ] one 
gDumpFlleOpenFlag " false 
end If 
fnd Sub 

Listing 9 shows the cast* siateiticnt insitle a four-'pass do 
loop thnt creates a new file in each pa.ss fuil the fourth, in each 
case Inn ilie finsT taking input from ihe output file of the 
previous pass. 
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Hooking up 

Once your program is written, you need to get it into the 
controller. With modern Maes that means a sediil port must be 
added either with a IJSB-to-seriai converter or a PCI bus card 
wiili serial ports. Keyspan is one source for lx)di types. Tile 
internet auction sites such as ebay commonly offer adapters 
from varioiLs sources. Additional suitable cables and/or adapters 
and st>ftware drivers may also be required, exact needs 
determined by the controller being used. The recent article by 
Torn Djajadiningrat in MacTecli 20:2 has a very good disatssion 
of Mac serial issues, 

if youVe using a Keyspan USA-28X USlMo-serial adapter 
or a Keyspan SX Pro PCI serial card and your controller is a 
Micromint BCC-52, you'll need an old style Mac mrxlem calrle 
with a DB-25 male connector at one end and a minfeDINS male 
at the other. TrippLite is one source for this type of cable. If ytnir 
controller is a New Micros 68IICll-based model supplicxl with 
an RS-232 cable designed for the WtnTel set, a bit of custom 
adapting may be needed. RS-232 interfacing Ls something of a 
black art whose practitioners require familiarity with breakout 
boxes, logic prolx?s, soldering irons and strong coffee. 

Tlie shareware program ZTerm is probably the simplest 
software to use to download a converted program to the 
controller Set the parms to BNl and 9600 Baud, then select local 
from the Dial menu. Hit "Knter" and you sliould get a prompt. 
BASlCll uses a ^splat" prompt; BASJC-52 uses Use the 
Settings : Text Pacing menu to set character and line delays and 
the BASIC prompt for smooth transfers, To initiate the mmsfer, 
selea Send text from Z'lerm's File menu, then choose the file, 
e.g. blinky.bas in the navigation dialog. 

Sources 

ZTemi - http://homepage.mac.com/dalverson/zlerm/ 

New Mic:ros IncoqK)rated - http://www,newmicros.CDm/ 

Micromint - http://www.microminT,cofn/ 


70 


BASIC Cons BASIC 


MacTecii • VoMiME 20, Issue 6 







Peachpit 

jjg 


New From Peachpit Press! 



With self-paced lessons based on the AppleCare 
Service Technician Portable and Desktop Systems 
certification exam, this guide is the perfect 
supplement to Apple's own training class. It's 
also a first-rate primer for computer support 
personnel who need to troubleshoot Macs as 
part of their jobs. 

This Apple-certified course-in-a-book begins 
with an introduction to troubleshooting tools 
and practices before moving on to an 
exploration of common hardware and 
underlying technologies (LCDs, CRTs, networks, 
and more). Once grounded, you'll delve into 
the nitty-gritty operation of Apple's various 
desktop and portable computer models. The 
book's companion DVD also includes four service 
manuals with complete documentation and 
diagnostic tools for repairing a sample-mode! 
IBook, desktop Mac, PowerBook, and I Mac. 


A Must-Have For 
Anyone Who Supports and 
Repairs Apple Products! 


More Apple Training Titles! 


Apple Training Series ILife '04 
ISBN: 0-321-25606-9 

Apple Training Series: GarageBand 
ISBN: 0-321-26876-8 

Apple Training Series: Mac OS X Help Desk 
ISBN: 0-321-27848-8 



Apple 

Certified 
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Multiple formats. Multiple platforms. 
Complex installers. 

Aladdin solves the compression and installation puzzle. 


IVying to figure out how to handle multiple 
compression formats and platforms? 

The Stuffit Engine solves the compression puzzle. 

Aladdin’s Stuffit Engine SDK; 

> Adds value to your application by integmling powerful compression and encryption. 
>■ Is the only tool that supports the Stuffit file format. 

>■ Provides a single API that supports over 20 compression and 

encoding formats common on Macintosh, Windows, and Unix. 

> Makes self-extracting archives for eitlier Macintosh or Windows. 

>■ Av ail able for Macintosh, Windows, Linux, or Solaris. 

Stuffit Engine SDK~ 

The power of stuffit in your software. 


IJcenses start as low 
as 

To learn more, visiii 
www.sluffil.cam/sdk/ 




Looking for the easiest and fastest 
way to build an installer? 

Slujpi InstallerMaker completes your puzzle. 


It's not enough just to write solid code anymore. You still have to write an installer 

for your users. Stuffit InstallerMaker makes it simple and effective. 

> Stuffit InstallerMaker gives you all the tools you need to install, uninstall, 
resource-compress or update your software in one complete, 
ea.sy-to-use pack^^e. 

>- Add marketing muscle to your installers by customizing 
your electronic registration form to include surveys 
and special offers. 

>• Make demoware in minutes. Create Macintosh 
OS X and Macintosh Classic compatible installers 
with Stuffit InstallerMaker. 

Stuffit InstallerMaker 

The complete installation solution.'" 


Prices Slam m $250 

To leara more, visiL 
www.stuffiLcom/ 
installennaker/ 


.^^kAladdin 
w^Systems t 

www.stufiit.com 
(831) 761-6200 

C 2002 Aladdin SyxIamB, 
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Runtime Revolution • 91 Hanover Street • Edinburgh EH2 1DJ ' UK ' 

Phone +44 (0)131 718 4333 • Fax +44 (0) 845 458 8487 »wwwHrunrev.com * Email-lnfo@runrev.com 
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Revolution; the English Hke language 
designed around the way you think. 

Develop fast and deiiyer at the click of a button Ojfi 12 pla^ Mac OS X, Windows and Llnux?^* 

Supportfor XML, SQL databases, video capture, Unicode, Reports, faceless CGi applications, and more. 


For as tittle as S149 you can create applications, storyboard projects, manage your databases, build courseware, 
work with the Internet, create "quick and dirty" solutions to those niggling office tasks 
in minutes, ship polished programs in hours or days instead of weeks and months... 


Thousands of developers have already joined the Revolution. Can you afford to wait? 

Scale the peaks with Revolution! 













